Sub-agent（子代理）
主 Agent 派出的「小幫手」——獨立 context 跑，回報結果給主 Agent。主 agent 不被它的中間日誌淹沒。
主 Agent vs Sub-agent
| 項目 | 主 Agent | Sub-agent |
|---|---|---|
| Context | 全專案脈絡 | 隔離窗口 |
| 執行 | 逐一派任務 | 可並行 5+ 個 |
| 回報 | 詳細過程 | 摘要結果 |
| 適用 | 協調流程 | 特定深度任務 |
Cowork 內建 5 種
| 類型 | 用途 |
|---|---|
| claude-code-guide | Claude 知識顧問（查官方文件） |
| Explore | codebase 探索（parallel grep） |
| general-purpose | 通用代理（自由分析） |
| Plan | 架構師（系統設計） |
| statusline-setup | 系統內部用 |
何時派
✅ 深度專注一個檔案 / 服務 ✅ 任務會產生大量日誌（grep / search） ✅ 想並行 3+ 個無關任務
❌ 跨檔案協調邏輯 ❌ 需要細緻人工審查的結果
寫好 Sub-agent Prompt
關鍵差異：sub-agent 沒有看過您前面的對話，prompt 必須完全自包含。
❌ 不好
根據上面的程式碼，幫我 review
✅ 好
請開啟絕對路徑：
/Users/vincent/Projects/ExamSystem/Controllers/HrController.cs
掃描所有 SQL query，檢查 SQL injection 風險：
- 是否使用 parameterized query？
- 有沒有直接拼接使用者輸入？
回報格式 JSON：
{ filename, lineNo, risk, fix }
平行派 Agent
✅ 適合：
- 5 支 controller 各自 review，無依賴
- 同時掃 dev / staging / prod 日誌
❌ 不適合：
- A 結果是 B 輸入
- 需全局一致性
升級為 Agent Teams（2026/02）
需要長期、跨對話的 agent 協作 → 升級成 Agent Teams：
| Sub-agent | Agent Teams | |
|---|---|---|
| 生命週期 | 單次任務即丟 | 跨對話保留 |
| 規模 | 1 派 N | 最多 10 隻 |
| 適合 | 即興併發 | 持久性團隊 |
→ 簡單併發用 sub-agent，大型重構用 Agent Teams。
對 PAM 的應用
剛剛我們做 Karpathy LLM Wiki 編譯時就用過——派 4 個 claude-code-guide sub-agent 平行研究 Code / Skill / MCP / Agent，每個寫 1 章。20 分鐘搞定原本要 1 小時的工作。
派 3 個 sub-agent 平行：
1. Explore：掃 backend/ 找直接拼 SQL
2. Explore：掃 frontend/ 找缺授權檢查
3. Plan：分析 ServiceLayer 架構
相關概念
強連結（原文明確提及）
- Agent Loop — Sub-agent 內部也是 loop
- Agent Teams — 持久性多 agent 協作
- Tasks 任務管理 — 配合 sub-agent 派工
- Cowork
- Claude API — Agent SDK
- Boris Cherny 13 條心法 — Boris 第 6 條：子代理用任務型不要角色型
推斷連結（LLM 認為相關，待確認）
深入閱讀（外部資源）
- 深入閱讀：12-Agent 建置與使用
← 回到 wiki