主 Agent 派出的「小幫手」——獨立 context 跑，回報結果給主 Agent。主 agent 不被它的中間日誌淹沒。

主 Agent vs Sub-agent

項目 主 Agent Sub-agent
Context 全專案脈絡 隔離窗口
執行 逐一派任務 可並行 5+
回報 詳細過程 摘要結果

Cowork 內建 5 種

類型 用途
claude-code-guide Claude 知識顧問
Explore codebase 探索
general-purpose 通用代理
Plan 架構師
statusline-setup 系統內部

何時派

✅ 深度專注一個檔案

✅ 任務會產生大量日誌

✅ 想並行 3+ 個任務

❌ 跨檔案協調邏輯

❌ 需人工審查

寫好 Sub-agent Prompt

關鍵：sub-agent 沒看過您前面的對話，prompt 必須完全自包含。

❌ 不好

根據上面的程式碼，幫我 review

✅ 好

請開啟絕對路徑：
/Users/vincent/Projects/ExamSystem/Controllers/HrController.cs

掃描所有 SQL query，檢查 SQL injection 風險。

回報格式 JSON：
{ filename, lineNo, risk, fix }

並行派

✅ 5 支 controller 各自 review、同時掃多個環境日誌

❌ A 結果是 B 輸入、需全局一致性