寫(xiě)完 Claude Code Skills 實(shí)戰(zhàn) 之后，我意識(shí)到一個(gè)問(wèn)題：?jiǎn)慰?Skills 是很難講清楚的——Skills 的價(jià)值要通過(guò)它和 Subagents、MCP、Agent Teams 之間的關(guān)系才能體現(xiàn)出來(lái)。

5 月初 Anthropic 官方公布了 Claude Code 的"五層架構(gòu)"——MCP / Skills / Agent / Subagents / Agent Teams。這個(gè)分層不是營(yíng)銷(xiāo)話術(shù)，每層都有明確的職責(zé)邊界和協(xié)作方向。文章按層拆解定位、配置字段和何時(shí)用哪一層，最后用我博客里實(shí)際跑的 blog-preflight 案例演示三層是怎么聯(lián)動(dòng)的。

五層架構(gòu)總覽

先用一句話概括每層的角色：

最容易混淆的是 Skills、Subagents、Agent Teams——它們都和"任務(wù)"有關(guān)。區(qū)分點(diǎn)在上下文隔離粒度：

• Skills：在主對(duì)話上下文里執(zhí)行（除非 context: fork）
• Subagents：每個(gè) Subagent 獨(dú)立上下文，單會(huì)話內(nèi)協(xié)作
• Agent Teams：每個(gè)成員獨(dú)立會(huì)話 + 獨(dú)立上下文，跨會(huì)話協(xié)調(diào)

第一層：MCP（Model Context Protocol）

MCP 是底層連接器。它解決的問(wèn)題是："讓 Claude 能訪問(wèn) GitHub、數(shù)據(jù)庫(kù)、Notion、內(nèi)部 API、Linear，而不需要給每個(gè)服務(wù)寫(xiě)自定義代碼。"

三種使用模式

1. 全局配置（.mcp.json）

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

任何 Claude Code 會(huì)話都能用 github 這個(gè)服務(wù)器。

2. Subagent 內(nèi)聯(lián)（僅 Subagent 可見(jiàn)）

name: browser-tester
description: 用 Playwright 在真實(shí)瀏覽器里測(cè)試功能
mcpServers:
  - playwright:
      type: stdio
      command: npx
      args: ["-y", "@playwright/mcp@latest"]

Playwright MCP 只在這個(gè) Subagent 啟動(dòng)時(shí)連接，結(jié)束時(shí)斷開(kāi)。主對(duì)話看不到它的工具描述，節(jié)省 token。

3. 引用全局服務(wù)器

mcpServers:
  - github   # 引用 .mcp.json 中已配置的服務(wù)器

什么時(shí)候用 MCP

• 需要訪問(wèn)帶狀態(tài)的外部系統(tǒng)（GitHub Issue、Linear ticket、數(shù)據(jù)庫(kù)）
• 工具能力是通用、跨項(xiàng)目復(fù)用的（不是某個(gè)項(xiàng)目特有邏輯）
• 不希望工具的實(shí)現(xiàn)細(xì)節(jié)侵入項(xiàng)目代碼

如果只是"格式化博客 frontmatter"這種純本地腳本邏輯，用 Skill 比寫(xiě)一個(gè) MCP server 簡(jiǎn)單一個(gè)量級(jí)。

第二層：Skills

Skills 是"任務(wù)知識(shí)"層——把你重復(fù)粘貼的指令變成 Claude 自動(dòng)加載的資源。這部分細(xì)節(jié)我在 blog158 寫(xiě)過(guò)，這里只補(bǔ)兩點(diǎn)和后面層級(jí)有關(guān)的：

Skill 與 Subagent 的雙向關(guān)系

這是五層架構(gòu)里最容易繞暈的點(diǎn)。Skill 和 Subagent 之間存在兩個(gè)相反方向的協(xié)作：

兩者底層是同一套機(jī)制，但觸發(fā)方向相反：

Skill 調(diào) Subagent                    Subagent 預(yù)加載 Skill
─────────────────                    ────────────────────
你 → Skill                            你 → Subagent
       ↓ context: fork                       ↓ skills: [...]
     Subagent (Explore/Plan/...)             含 Skill 內(nèi)容的 Subagent
       ↓ 用 SKILL.md 作為 task               ↓ 自己的 prompt + Skill 知識(shí)
     返回結(jié)論                                返回結(jié)論

決策樹(shù)：什么時(shí)候用哪個(gè)

有"指令模板"想固化下來(lái)？
  └─ 是 → Skill
       ↓
       Skill 內(nèi)容很長(zhǎng) + 會(huì)產(chǎn)生大量探索/調(diào)試輸出？
         └─ 是 → 加 context: fork（讓 Subagent 跑這個(gè) Skill）
         └─ 否 → 普通 Skill，主對(duì)話執(zhí)行

需要"專門(mén)類(lèi)型的工作者"反復(fù)出現(xiàn)（比如 code-reviewer、db-reader）？
  └─ 是 → Subagent
       ↓
       這個(gè)工作者有反復(fù)使用的領(lǐng)域知識(shí)？
         └─ 是 → 在 Subagent 里 preload Skills
         └─ 否 → 直接寫(xiě)在 Subagent 的 system prompt 里

第三層：Agent（主工作者）

Agent 是你和 Claude Code 對(duì)話的主線。claude 命令啟動(dòng)的就是默認(rèn) Agent，使用 Claude Code 默認(rèn) system prompt + 你的 CLAUDE.md。

用--agent讓整個(gè)會(huì)話變成專項(xiàng) Agent

# 啟動(dòng)后整個(gè)會(huì)話都是 code-reviewer，使用它的 system prompt 和工具限制
claude --agent code-reviewer

或在項(xiàng)目里設(shè)默認(rèn)：

// .claude/settings.json
{
  "agent": "code-reviewer"
}

這是把"專門(mén)工作者"提升到主線層級(jí)的方式——和 Subagent 的區(qū)別是：主 Agent 你能自由對(duì)話，Subagent 是被任務(wù)驅(qū)動(dòng)跑完一次就結(jié)束。

主 Agent 能 spawn Subagent，但 Subagent 不能 spawn Subagent

這是個(gè)硬約束。從架構(gòu)圖看：

Main Agent (claude 或 claude --agent <name>)
  ├── 可以 spawn Subagent A
  ├── 可以 spawn Subagent B
  └── 可以 spawn Subagent C
        └── ? 不能再 spawn 其他 Subagent

如果你需要嵌套委派，用 Skills（Skill 可以 fork 出 Subagent，繞開(kāi)這個(gè)限制）或者 chain subagents（讓 Main Agent 順序調(diào)用多個(gè) Subagent）。

第四層：Subagents

Subagent 是單會(huì)話內(nèi)的專項(xiàng)工作者。它的 frontmatter 字段比 Skill 多一些，列幾個(gè)最關(guān)鍵的：

完整字段還有 maxTurns、hooks、effort、color、initialPrompt 等，參見(jiàn) 官方文檔。

命名風(fēng)格提醒：Skill 用 allowed-tools（短橫線），Subagent 用 tools / disallowedTools（駝峰）。兩套風(fēng)格不一致，寫(xiě)的時(shí)候容易抄錯(cuò)。

Subagent 持久記憶機(jī)制（最被低估的特性）

加 memory: project 后，Subagent 獲得一個(gè)持久目錄：

.claude/agent-memory/<subagent-name>/
├── MEMORY.md     # Claude 啟動(dòng)時(shí)讀前 200 行
└── 其他筆記文件

Subagent 在每次任務(wù)后主動(dòng)更新自己的記憶——比如 code-reviewer 會(huì)記下"這個(gè)項(xiàng)目的 React 組件總是用 forwardRef 包裝"、"BUG 經(jīng)常出在 useEffect 沒(méi)列依賴"。下次它再被調(diào)用時(shí)，會(huì)先讀自己的 MEMORY.md，然后把這些累積的洞察用上。

name: code-reviewer
description: 審查代碼質(zhì)量。審?fù)昕偸歉伦约旱挠洃?
memory: project

You are a code reviewer. Before reviewing, read your MEMORY.md to recall
patterns from past reviews. After reviewing, update MEMORY.md with new
patterns, anti-patterns, and recurring issues you discovered.

三個(gè)作用域選擇：

• user（~/.claude/agent-memory/<name>/）—— 跨所有項(xiàng)目，比如"我喜歡用 TypeScript 嚴(yán)格模式"這種全局偏好
• project（.claude/agent-memory/<name>/）—— 項(xiàng)目特定，可入 git，團(tuán)隊(duì)共享
• local（.claude/agent-memory-local/<name>/）—— 項(xiàng)目特定但不入 git，比如個(gè)人調(diào)試筆記

內(nèi)置 Subagent

Claude Code 自帶幾個(gè)：

Explore 用 Haiku 是設(shè)計(jì)選擇——大多數(shù)代碼搜索任務(wù)不需要 Opus 的推理深度，Haiku 快且便宜。

第五層：Agent Teams

Agent Teams 解決的是 Subagent 解決不了的場(chǎng)景——多 Agent 長(zhǎng)期并行 + 跨會(huì)話協(xié)調(diào)。

Subagent 的限制：

• 單會(huì)話內(nèi)
• 任務(wù)完成就結(jié)束
• 主 Agent → Subagent 是單向關(guān)系

Agent Teams 把每個(gè)成員升級(jí)為獨(dú)立會(huì)話 + 獨(dú)立上下文，成員之間通過(guò) SendMessage 工具互相對(duì)話，由協(xié)調(diào)者 Agent 編排。

啟用方式：

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

適用場(chǎng)景：

• 長(zhǎng)時(shí)間運(yùn)行的復(fù)雜項(xiàng)目（比如完整產(chǎn)品功能開(kāi)發(fā)：設(shè)計(jì) → 實(shí)現(xiàn) → 測(cè)試 → 文檔）
• 各成員需要長(zhǎng)記憶和持續(xù)狀態(tài)
• 任務(wù)能拆解成幾個(gè)獨(dú)立但有交互的子任務(wù)

如果你的工作流單會(huì)話就能跑完，別用 Agent Teams。它的復(fù)雜度對(duì)單會(huì)話場(chǎng)景是負(fù)價(jià)值。

一個(gè)直觀對(duì)比

Subagent（單會(huì)話）                         Agent Teams（多會(huì)話協(xié)調(diào)）
──────────────────                         ────────────────────────
Main Agent                                 Coordinator Agent
  ├── Subagent A 跑完返回                    ├── ← Teammate A（獨(dú)立會(huì)話）
  ├── Subagent B 跑完返回                    │     ? SendMessage
  └── 綜合結(jié)果給你                            ├── ← Teammate B（獨(dú)立會(huì)話）
                                             └── 長(zhǎng)期協(xié)作
特點(diǎn)：                                      特點(diǎn)：
- 一次性                                    - 持續(xù)性
- A 和 B 不互相通訊                          - 成員間直接通訊
- 單上下文樹(shù)                                 - 每個(gè)成員自己的會(huì)話

實(shí)戰(zhàn)：博客發(fā)布前自檢的三層聯(lián)動(dòng)

我博客的 blog-preflight Skill 就是 Skills + Subagents + MCP 三層組合的真實(shí)例子。

當(dāng)前實(shí)現(xiàn)（僅 Skill 層）

參見(jiàn) blog158 — 用 context: fork 把 Skill 跑在 Explore Subagent 里：

name: blog-preflight
description: 博客發(fā)布前自檢。在我說(shuō)"準(zhǔn)備發(fā)布"或部署前主動(dòng)調(diào)用
context: fork
agent: Explore
allowed-tools: Read Grep Bash(grep:*) Bash(node:*)

# 檢查清單
1. frontmatter 完整性
2. 隱私掃描
3. AI 味詞匯
...

這只是 Skill + Subagent 聯(lián)動(dòng)。

升級(jí)為三層聯(lián)動(dòng)

如果我想讓 Claude 在審查時(shí)記住前幾次發(fā)現(xiàn)的問(wèn)題模式（比如"上次某篇文章用了'標(biāo)志著'被我改了，下次寫(xiě)時(shí)優(yōu)先避開(kāi)"），就需要把 preflight 升級(jí)成一個(gè)帶持久記憶的 Subagent，再讓原 Skill 調(diào)用它：

第一步：定義 Subagent

# .claude/agents/blog-preflight-checker.md
name: blog-preflight-checker
description: 博客發(fā)布前自檢專家。審查 frontmatter、隱私、AI 痕跡，并積累項(xiàng)目特定的寫(xiě)作問(wèn)題模式
tools: Read, Grep, Bash
model: sonnet
memory: project
mcpServers:
  - github  # 復(fù)用全局 GitHub MCP，用來(lái)查 PR 歷史
skills:
  - blog-preflight  # 復(fù)用已有的檢查清單 Skill

You are a blog preflight checker. Before reviewing:
1. 讀 .claude/agent-memory/blog-preflight-checker/MEMORY.md，回顧以往發(fā)現(xiàn)的常見(jiàn)問(wèn)題
2. 應(yīng)用 preloaded blog-preflight skill 的檢查清單

After reviewing, update MEMORY.md with:
- 這次新發(fā)現(xiàn)的問(wèn)題模式
- 歷史問(wèn)題在新文章里是否仍出現(xiàn)
- 哪些檢查項(xiàng)是過(guò)度的（被作者反復(fù)忽略，可降級(jí)）

第二步：觸發(fā)

你: 用 blog-preflight-checker 檢查 blog160 這篇
  ↓
Main Agent → 委派 Subagent
  ↓
Subagent 啟動(dòng):
  - 加載 blog-preflight Skill 內(nèi)容（preloaded）
  - 讀 MEMORY.md 看歷史問(wèn)題
  - 通過(guò) GitHub MCP 查最近幾篇文章的修訂歷史（可選）
  - 跑檢查腳本
  - 寫(xiě)報(bào)告 + 更新 MEMORY.md
  ↓
返回主對(duì)話: 簡(jiǎn)短報(bào)告（"3 個(gè) ??，2 個(gè) ??"）

這就是五層架構(gòu)的實(shí)際效果：MCP（GitHub 歷史）+ Skills（檢查清單）+ Subagent（持久記憶 + 隔離上下文）三層各司其職。如果都堆在一個(gè)主對(duì)話里，會(huì)立即把 Claude 的上下文塞滿。

說(shuō)明：上面的 Subagent 配置是設(shè)計(jì)方案，演示三層組合，實(shí)際跑通還要看 memory 和 skills preload 在你項(xiàng)目里的兼容性，建議先小流量驗(yàn)證。

決策框架

回答"我該用哪一層"的問(wèn)題：

我有的是什么？
│
├── 一段重復(fù)粘貼的指令 / playbook？
│     → Skill（如果產(chǎn)生大量輸出，加 context: fork）
│
├── 一段需要從外部系統(tǒng)拉數(shù)據(jù)的邏輯？
│     → MCP server（如果是通用工具）
│       或者 Subagent inline mcpServers（如果只在某場(chǎng)景用）
│
├── 一類(lèi)反復(fù)出現(xiàn)的工作者（reviewer / debugger / db-reader）？
│     → Subagent
│       └── 需要跨會(huì)話累積知識(shí)？→ 加 memory: project
│       └── 有領(lǐng)域知識(shí)要預(yù)先注入？→ 加 skills: [...]
│
├── 整個(gè)會(huì)話都用某個(gè)專項(xiàng)角色？
│     → claude --agent <name>
│
└── 多 Agent 長(zhǎng)期并行 + 跨會(huì)話協(xié)調(diào)？
      → Agent Teams（experimental，慎用）

常見(jiàn)誤解澄清

"Subagent 比 Skill 更高級(jí)"

**錯(cuò)。**它們解決的是不同問(wèn)題：

• Skills = "把指令固化，可被加載"
• Subagent = "把工作者隔離，可有獨(dú)立 context 和工具"

簡(jiǎn)單的"按某 playbook 做事"用 Skill 就夠了。只有當(dāng)主對(duì)話上下文會(huì)被這次任務(wù)污染時(shí)，才考慮用 Subagent。

"用了 Subagent 就比 Skill 慢/貴"

部分對(duì)。Subagent 啟動(dòng)有 latency（要重新建上下文），但它省 token——大量探索/調(diào)試輸出留在子上下文里，不會(huì)進(jìn)主對(duì)話歷史。當(dāng)任務(wù)輸出超過(guò) 5K token 時(shí)，用 Subagent 反而更便宜。

"Subagent 能 spawn 其他 Subagent"

不能。這是硬限制。如果你想嵌套委派，方案是：

• 用 Skills（Skill 可以 fork Subagent，跨過(guò)這個(gè)限制）
• 或者從 Main Agent chain：Subagent A 完成 → Main Agent 拿結(jié)果 → 委派 Subagent B

"skills 字段把 Skill 注冊(cè)給 Subagent，Subagent 能用 / 命令調(diào)用"

錯(cuò)。skills 字段是預(yù)加載——把 Skill 內(nèi)容直接注入 Subagent 的 system prompt。Subagent 看到的是 Skill 的指令文本，不是一個(gè)可被 /skill-name 調(diào)用的命令。

"User scope memory 會(huì)跨項(xiàng)目串味"

會(huì)，但這正是它的價(jià)值。如果你不想跨項(xiàng)目共享，用 memory: project（倉(cāng)庫(kù)內(nèi)）或 memory: local（不入 git）。

落地建議

如果你剛開(kāi)始用 Claude Code 的高級(jí)功能，按這個(gè)順序?qū)W：

1. 第 1 周：先把所有重復(fù)指令變成 Skills，體會(huì)"按需加載"的效果
2. 第 2 周：當(dāng)某個(gè) Skill 輸出爆炸時(shí)，加 context: fork，體會(huì)上下文隔離
3. 第 3 周：設(shè)計(jì)第一個(gè)帶 memory 的 Subagent，讓它跨會(huì)話累積知識(shí)
4. 第 4 周：把項(xiàng)目里 GitHub / Linear / 數(shù)據(jù)庫(kù)這種"外部狀態(tài)"接入 MCP
5. 第 N 周：真正復(fù)雜的產(chǎn)品級(jí)協(xié)作再考慮 Agent Teams

不要一開(kāi)始就上 Agent Teams——多數(shù)場(chǎng)景 Subagent + Skills + MCP 已經(jīng)夠了。"工具不在多，而在用對(duì)地方"——這句話在 Claude Code 這套架構(gòu)上格外貼切。

以上就是一文詳解Claude Code中的五層架構(gòu):MCP、Skills、Agent、Subagents、Agent Teams怎么協(xié)作的詳細(xì)內(nèi)容，更多關(guān)于Claude Code中的架構(gòu)詳解的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論