Claude Code 子代理點分工：獨立調查，集中整合

先分清工作有冇依賴

你想審閱一個 PR，可以分開讀邏輯、檢查測試同核對文件。呢幾份調查可以獨立開始，但最後嘅 PR 說明要等實際結果，唔應先猜測測試全部通過。

子代理（subagent）有自己嘅上下文，完成後交返結果。並行可能縮短等待，但亦會增加讀取、模型用量同整合工夫，唔保證開四個就快四倍。

1. 先用自然語言分派

唔需要將網上嘅 Agent(...) 偽代碼當成 Terminal 指令。直接向 Claude Code 交代：

請用兩個子代理獨立調查今次指定提交範圍，唔修改檔案。

第一個：讀完整差異同相關呼叫端，找有證據嘅行為問題。
第二個：讀相關測試，指出今次改動未驗證嘅情況；冇實際覆蓋率報告就唔報百分比。

兩者都要列出讀過嘅檔案、證據、未確認範圍同建議下一步。唔湊固定問題數目，冇發現就如實講。

你收到結果後，核對重複同矛盾，追讀重要位置，再交一份整合報告。

內建類型同可用功能會隨版本改，參考官方子代理文件。唔好假設每部機都有叫 security-reviewer 或 code-reviewer 嘅內建代理。

2. 重複用先建立自訂代理

例如經常核對文件同程式是否一致，可以建立 .claude/agents/docs-checker.md：

---
name: docs-checker
description: 比對指定文件同相關程式，指出已過時或缺證據嘅內容
tools: Read, Grep, Glob
---

先確認指定範圍，讀文件同相關實作。
每個差異附兩邊檔案位置同原因。
分開已確認差異、需要執行先驗證，同未讀範圍。
唔修改檔案，唔編造測試或成功結果。
冇發現可確認差異就如實回報，唔湊數。

工具清單配合任務：呢個代理只做檔案閱讀，唔會替你跑建置。如果需要測試，另由有適當工具嘅程序執行，唔好暗中擴大權限。

主動指定「用 docs-checker 檢查指定文件」再核對實際呼叫記錄。若新定義未載入，按版本文件排查，必要時重開對話。/agents 嘅管理介面亦有版本差異。

3. 每份任務都寫齊交接

子代理未必承接你之前所有對話，某些內建類型亦會省略部分專案背景。交代目標、基準版本、檔案範圍、限制、已有發現同輸出要求，唔好只寫「幫我睇下」。

理想輸出包括結論、檔案證據、實際執行指令同限制。長報告可以存檔，再回傳摘要同路徑；主代理仍要追讀重要發現，唔只複述摘要。

4. 共用檔案只留一個寫入者

兩個代理同時改同一份檔案，可能互相覆蓋。就算分開原始碼，亦可能撞鎖定檔、產生文件、測試資料或者同一個本機服務。

入門做法係子代理只調查，主代理順序修改。真係要並行寫入，就隔離 worktree、明確分配範圍，再安排整合驗證。有先後依賴嘅介面改動，先定合約，唔好各自創一套。

測試同 lint 能否並行亦要睇會唔會改共用產物。唔好見到係兩條命令，就當一定互不影響。

5. 結果要核對，唔係投票

三個代理都話冇問題，可能只係三個都漏咗同一條路徑。反過來，一個有具體重現證據嘅發現，唔應因為其他代理冇提就被省略。

整合時保留每個重要結論嘅來源，分開「讀過程式推測」同「工具實測」。未跑測試唔寫通過，未完整讀取唔寫全面審閱。

遞迴分派同代理數量限制受版本、工具同設定影響，唔應當成任何環境都能無限使用。通常先由少量獨立任務開始，確定交接同整合有幫助，再擴大。

簡單查詢、同一個函數嘅小修改，直接喺主對話完成可能更合適。分工嘅目的係令每份工作更清楚，唔係追求代理數量。