agent-teams

agent-teams 技能總覽

agent-teams 是做什麼用的

agent-teams 是一個給 Claude Code 使用的工作流程技能，適合需要多代理協作、而且採用嚴格 TDD 流程的專案。當你需要的是有協調性的功能交付，而不只是一次性的提示詞時，就該用 agent-teams skill：規格撰寫、品質把關、實作代理、審查、安全掃描，以及 PR／分支編排，都會像一個團隊那樣分工合作。

哪些人應該安裝

如果你的團隊使用 alinaqi/claude-bootstrap，而且希望代理角色可重複使用、交接流程有強制約束，這套技能就很適合。它特別適合重視 test-first 執行、卡在品質檢查前的阻擋流程，以及希望降低功能分支中「agent drift」的情境。

它有什麼不同

最大的差異在於這條不可變更的功能管線：spec、review、失敗測試、紅燈驗證、實作、綠燈驗證、程式碼審查、安全掃描，以及 PR 建立。agent-teams for Multi-Agent Systems 這種模式本來就帶有明確立場，流程也偏重，這正是設計目的；如果你要的是一致性與可追蹤性，而不是彈性，它會很有幫助。

如何使用 agent-teams 技能

安裝並找到技能檔案

先從你的 Claude Code 技能管理器走 agent-teams install 流程，接著先檢查 skills/agent-teams/SKILL.md。這個 repository 不依賴額外的 rules/、resources/ 或 scripts/ 輔助檔，因此 skills/agent-teams/agents/ 底下的代理定義就是最重要的支援檔案。

先讀哪些內容

先從 SKILL.md 開始，再查看：

• agents/feature.md
• agents/quality.md
• agents/code-review.md
• agents/security.md
• agents/merger.md
• agents/team-lead.md

這些檔案會說明團隊預期怎麼行動、每個角色可使用哪些工具，以及阻擋檢查會在哪裡發生。這比快速掃過更重要，因為 agent-teams usage 依賴的是角色邊界，而不只是提示詞措辭。

要怎麼寫提示詞才有效

最好的輸入是一個包含範圍、repo 背景與限制條件的功能目標。舉例來說，不要只說「加上 auth」，而要提供：

• 目標檔案或子系統
• 驗收條件
• 測試框架
• 效能／安全限制
• 任何代理不能改動的內容

一個好的 agent-teams guide 提示詞，應該把「完成」定義清楚。如果你沒有精準指定行為，品質代理雖然還是會卡流程，但功能代理可能只會寫很窄的測試，或漏掉邊界情況。

什麼情況下最適合用

當功能需要平行化規劃、test-first 實作、審查與安全檢查時，最適合使用它。對於很小的修補、探索性原型，或需求高度模糊的任務，它就沒那麼划算；這時完整團隊流程的額外成本，反而會拖慢你。

agent-teams 技能 FAQ

這適合初學者嗎？

可以，只要你看得懂代理檔案和測試輸出。這個流程很嚴格，所以初學者會得到結構，但仍然需要提供清楚目標，並理解失敗本來就是流程的一部分。

這和一般提示詞有什麼不同？

一般提示詞是讓單一模型把所有事情都做完。agent-teams 則是把責任拆給不同代理，並且在每個關卡都通過之前不讓流程往下走。這通常能提升多步驟工作的可靠性，但也會增加儀式化步驟。

在 claude-bootstrap 以外也能用嗎？

不能把它當成直接可保證可用的套件。這個技能是依照 claude-bootstrap 的代理布局、.claude/agents/ frontmatter，以及 SKILL.md 裡描述的任務鏈來設計的。離開這個生態系，你可能需要調整檔案路徑與編排慣例。

什麼情況下不該用 agent-teams？

如果只是單一檔案編修、緊急 hotfix，或專案根本沒有像樣的測試套件，就先不要用。當你無法支援 TDD、review 與 security gates 時，這套流程會比一般提示詞更沉重。

如何改進 agent-teams 技能

給團隊更好的輸入

品質提升最大的關鍵，在於更精準的驗收條件。請包含預期輸入、輸出、邊界情況，以及功能必須遵循的既有慣例。這能幫助功能代理寫出真正對應你意圖的測試，而不是靠猜。

降低管線中的失敗點

常見問題包括規格太模糊、缺少測試指令，以及檔案歸屬不清。若你知道專案的 test runner、lint 指令與 package manager，就應該先講清楚。如果某個功能會碰到共用程式碼，也要明確指出，避免不同代理之間互相衝突。

第一次執行後再迭代

先用第一輪把缺口暴露出來，接著再在第二輪之前修正規格或限制條件。對 agent-teams 來說，改進通常代表更清楚的任務邊界、更強的負面案例，以及更明確定義品質與安全代理該在哪些情況下阻擋流程。

依你的 repo 做調整

如果你的 repository 架構特殊，或測試模式不標準，請在提示詞與連結的代理檔案中明確說明。你的輸入越貼近 repo 的真實限制，團隊就越不容易滑向泛化的 TDD 行為，而 agent-teams 安裝後在實務上的表現也會更好。