Claude Code 三層架構

概念

Claude Code ���層架構

定義

Claude Code 提供的三種可擴充機制,按職責分離:Command(入口點,.claude/commands/*.md)→ Agent(執行者,.claude/agents/*.md)→ Skill(知識庫,.claude/skills/*/SKILL.md)。分層的核心理由是「知識和流程的更新頻率不同」��

關鍵數據點(附來源)

  • Command 保持精簡,只指定啟動哪個 Agent(來源:Payload CMS 審查文章)
  • Agent 定義流程(收集 diff → 讀知識 → 逐項檢查 → 產出報告),不存具體知識(來源:Payload CMS 審查文章)
  • Skill 存完整的 checklist、程式碼範例、官方文件對應(來源:Payload CMS 審查文章)
  • 更新 checklist 只需改 Skill,Agent 和 Command 不用動���來源:Payload CMS 審查文章)
  • Hooks、CLAUDE.md、MCP、Skill、Sub-agent、背景任務——功能一個接一個推出(來源:工具選擇文章)

���提與局限性

  • 三層架構在程式碼審查場景被驗證有效,但在其他場景(如寫作、資料分析)是否需要 Agent 層仍待驗證
  • 如果只有一個 Skill、不需要條件路由,三層架構可能是過度設計
  • Agent 的流程假設是通用的(收集變更 → 讀知識 → 檢查 → 報告),不同團隊可能需要不同流程

衝突標記

無明確衝突。但寫作類 Skill 通常直接觸發,不經過 Agent 層,表明三層架構更適合複雜的多步驟審查場景���

關聯概念

  • [[Claude Code Skill 系統]]
  • [[CLAUDE.md 與記憶機制]]
  • [[AI 程式碼審查]]