Claude Code 多 Agent 怎麼管：Handoff + Takeover，只盯一個主 Agent（2026）

我用 Claude Code 管多個 agent，是討論完先把結果 handoff 成文件，再讓一個主 agent takeover 所有文件，由它分配 agent、開 worktree 再 merge，全部完成後跑 E2E test，我只需要盯著這個主 agent。

現在市面上有 Orca 這類工具，要同時管理好幾個 agent。問題是人的認知負擔會變重，很容易忘了之前叫哪個 AI 做什麼。我的經驗是，新開 Claude Code agent 的時候就先把名字取好，例如：

• <討論>api設計
• <主開發>5-1 後端

開啟時用 claude -n "<討論>api設計"，開了之後可以用 /rename 改。

handoff 和 takeover 的流程

這個概念是參考 Matt Pocock（知名軟體工程師）在 GitHub 開源的 skills（約 27 萬顆星）裡的 handoff。簡單說就是討論完交接到文件，文件累積多了，主 agent 一次讀取文件，自己編排開發、派 agent 處理。Matt 的 repo 裡只有 handoff，takeover 是我自己做的。

這樣理想上，一個專案開發都是一個主 agent 一直接手新的交接，你不需要管它。

1. 討論

討論的方式有很多種。

用 AI 開發，可能很多人有聽過或使用過 Matt Pocock 出的 grill-me skill。但你應該也有過被 100 個問題問瘋，或是被 Opus 5 這種「非人話」惡整的經驗。

雖然 Claude Code 官方現在已經新增了 output-style: Concise，讓它廢話少說。但你為什麼會希望 AI 少講？因為你還是需要它做決策。你既怕它廢話太多，增加自己的認知負擔；又怕它講太少，漏掉重要資訊。

grill-me 我自己是不喜歡用的，因為 AI 很容易問它自己就能解決的問題，甚至它自己都不知道這件事它其實可以直接解決。

我自己研究後，找到一個很好用的方式，就是讓 AI 提案，也就是讓它直接把解決方案寫出來。做法是先讓 AI 調查，做報告給你，你再決策。

但如果讓 AI 隨便提案，又會有另一個問題，就是 AI 的建議根本不可靠。很多時候 AI 提出的建議其實是錯的，最後反而把你累死，搞到什麼都要草木皆兵。

所以為了避免 AI 亂提案，我會要求它在報告的檔案或是對話上，對「建議」做明確的分級。類似這樣（自己要客製化修改）：

## Suggestion Strength Marking

`建議（icon 等級名稱）：`. Level = how many hold: 查證／比較替代方案／對照使用者原話或已拍板規則。不確定選低級。

- 🏆 非常確信建議：三項全中
- 🔎 查證後建議：查證＋比較
- 📌 有依據建議：僅查證
- 💭 一般建議：純判斷

查證可以客製化定義，例如 search codebase、查網路、用 Context7 查 docs。

這樣做是為了處理 AI 建議不可靠的問題。AI 還是照樣給建議，只是你會知道每個建議有多值得相信，AI 也比較像在提案，不會一直把決策丟回來問你。

2. handoff（交接）

這部分可以建立一個 skill 專門處理。handoff 就是把某個任務交接出去，所以 handoff 的內容和資訊量要足夠讓接手的 agent 能完成任務。

下面是簡潔版，可以存成 ~/.claude/skills/handoff/SKILL.md：

---
name: handoff
description: 把這段對話的成果寫成交接紀錄，讓接手的 agent 只讀資料夾就能接續執行
disable-model-invocation: true
argument-hint: <主題>
---

把這段對話寫進 `docs/handoffs/<主題>/log.md`（已存在就在尾端追加）。

標準：接手的 agent 只讀這個資料夾就能理解前因後果並接續執行，
不需要回頭讀對話，也不需要回來問。

log.md 包含：

- 討論脈絡：問題從哪來、考慮過的方案、為什麼取捨
- 決策：結論與理由；已核定與待確認分開
- 待辦：從哪一步開始、每項要做出什麼、動哪些檔、怎麼驗收
- 現場：改過程式碼就照 git status / git log 寫 branch 與進度
- 未定案：待決問題、目前傾向、由誰決定

回報只講紀錄在哪、狀態是什麼。待辦已經交給接手的 agent，不要再列出來問使用者。

3. takeover（接手）

接手的 agent，模型必須開到 Opus 或 Fable 等級（目前是 Opus 5.5、Fable 5.1），不然編排上會出錯。

簡潔版，可以存成 ~/.claude/skills/takeover/SKILL.md：

---
name: takeover
description: 以主 agent 身分接手 docs/handoffs/ 的交接紀錄：讀完、排序、派工、審核、結案
disable-model-invocation: true
argument-hint: [主題資料夾…，留空＝全部]
---

1. 讀取：每個資料夾從 log.md 讀起，同資料夾的檔案全部讀完（done/ 除外）。
2. 建立全局：找出先後依賴、改到同一批檔案的重疊、互相矛盾的結論、未定案。
3. 只有矛盾或未定案才問使用者，其他直接開工。
4. 派工：互不重疊的派 subagent 並行；改到同一批檔案的各開 worktree。
5. 審核：每條線回報後跑 code review，沒過退回原 subagent。
6. 合併：review 通過後由你 merge 回主線，跑測試與 E2E。
7. 結案：每條待辦都有結果才結案，完成的資料夾搬進 handoffs/done/。

4. 主 agent 一次完成所有 handoff

這其中最大的好處是，主 agent 會自己分配 agent、開 worktree 再 merge，全部完成後再跑 E2E test 等，效率很高。

如果你分開自己管理，還會擔心每個 agent 偷懶之類的；如果只有一個主 agent，你只需要盯著它就好。

總結

整個流程就是開新 agent 先命名，討論時讓 AI 提案並把建議分級，討論完 handoff 成文件，最後交給一個主 agent takeover。

FAQ

Claude Code 怎麼幫 session 命名？

開啟時用 claude -n "名稱"，開了之後在 session 裡用 /rename 名稱 改。

Claude Code 的 worktree 會自動合併回主線嗎？

不會，要自己 merge。我的做法是交給主 agent 在 review 過後 merge。

handoff skill 要放在哪裡？

個人用放 ~/.claude/skills/handoff/SKILL.md，要跟團隊共用就放專案的 .claude/skills/handoff/SKILL.md。

參考資料

• mattpocock/skills
• Claude Code 官方文件：Sessions
• Claude Code 官方文件：Worktrees
• Orca