team-composition-patterns

team-composition-patterns 技能概覽

team-composition-patterns 是用於在 Claude Code Agent Teams 設計多代理團隊的決策技能，涵蓋團隊規模啟發式、agent 類型選擇與顯示模式。最適合需要可重複的團隊配置（用於審查、除錯或功能交付）的建置者，而不是臨時「隨便叫幾個代理」的提示。

team-composition-patterns 技能能幫你做哪些決定

它針對三個採用阻礙提供答案：要用幾個代理、每個角色該用哪種 subagent_type、以及在你的環境中哪種顯示模式可行（tmux、iTerm2、in‑process）。

最適合的情境與成果

當你需要在程式碼審查、錯誤調查或功能實作等任務上維持一致的團隊組成，且想要可重用的團隊預設而非每次重想角色時，就用它。

與通用提示的差異

不同於一般「建立一個團隊」的提示，這個技能把團隊規模的啟發式、預設配置，以及與代理能力綁定的 subagent_type 決策矩陣制度化。

什麼時候不適合

若你未使用 Claude Code Agent Teams，或你只需要單一助理處理簡單任務，這個技能會帶來額外負擔卻難有明顯收益。

如何使用 team-composition-patterns 技能

team-composition-patterns 安裝與入口

用這條指令安裝：npx skills add https://github.com/wshobson/agents --skill team-composition-patterns。核心指引在 plugins/agent-teams/skills/team-composition-patterns/SKILL.md。

採用前優先閱讀的檔案

先讀 SKILL.md，再看 references/agent-type-selection.md 了解 subagent_type 決策矩陣，最後讀 references/preset-teams.md 取得現成團隊組合與任務模板。

技能需要你提供的輸入

請提供任務類型（review/debug/feature/migration）、複雜度、限制條件（CI vs local），以及代理是否需要寫入權限。這些會直接對應到團隊規模與 subagent_type 選擇。

把模糊目標變成強提示

弱： “spawn a team to review this PR.”
強： “Review 6-file diff touching auth and caching; prioritize security and performance; local dev; need file:line findings and fixes.” 這樣技能就能選出合適的審查團隊預設與審查維度。

用團隊規模啟發式避免過量或不足

依任務複雜度匹配規模：簡單（1–2）、中等（2–3）、複雜（3–4+）。當你同時關注安全性 + 效能 + 架構等多維度時，才需要較大的團隊，不是因為程式碼量大就一定要人多。

使用 agent 類型決策矩陣

用 references/agent-type-selection.md 選擇 subagent_type。例如：程式碼審查 → agent-teams:team-reviewer；錯誤調查 → agent-teams:team-debugger；不修改程式碼的架構探索 → Plan 或 Explore。

先用預設團隊組合

預設團隊定義（review/debug）是最快得到價值的方式。它們包含成員角色、關注維度與結構化任務模板，讓每個代理都有清楚的維度與輸出格式。

依環境選擇顯示模式

若你需要多個並行輸出且能接受多窗格，建議 tmux。較輕量的設置可選 iTerm2 或 in‑process 以降低摩擦。

team-composition-patterns 使用建議流程

1. 定義任務類型與複雜度。
2. 依維度選擇預設或自訂團隊。
3. 為每個角色指定 subagent_type。
4. 依環境選擇顯示模式。
5. 提供結構化任務模板給每位隊友。

team-composition-patterns 技能 FAQ

team-composition-patterns 技能只適用於 Claude Code Agent Teams 嗎？

是的。它以 Agent Teams 的 subagent_type 與顯示模式為設計核心，沒有這個環境時，指引就不夠可行。

它與一般「建立團隊」提示有何不同？

它提供團隊規模的決策規則、agent 類型選擇矩陣，以及含任務模板的具體預設團隊，這些通常不在泛用提示中。

新手也適合嗎？

可以，只要使用預設團隊。決策矩陣可能密集，但能避免常見錯誤，例如把寫入權限交給探索型代理。

什麼情況應該避免使用？

對於一次性、低風險的任務，如果單一通用代理就夠，則不建議使用，因為協調成本可能大於收益。

支援像 migration 或稽核這類自訂流程嗎？

支援。技能明確涵蓋非標準流程；你可以透過組合維度並選擇合適的 subagent_type 角色，自行建立自訂團隊組成。

如何改進 team-composition-patterns 技能

提供更清楚的任務維度以改善團隊設計

請明確說出審查維度（安全性、效能、架構、測試）。維度清楚時，技能才能對應到預設審查角色並降低重疊。

避免常見失敗模式

失敗模式：選錯 subagent_type（例如需要修改卻選 Plan）。解法是明確說明是否需要寫檔，並依決策矩陣選擇。

用更強的輸入脈絡提升輸出

加入範圍指標如 “multi-file change”、“cross-cutting concern” 或 “CI-only environment”。這會影響建議的團隊規模與顯示模式。

在第一版建議後迭代

若結果太淺，補上一個缺失維度（例如 accessibility），或把團隊規模加一。若回應重複，則減少人數或縮小範圍。

為組織建立可重用模板

將 references/preset-teams.md 的預設任務模板調整成你們的 repo 慣例（檔案路徑、輸出格式、嚴重性等級）。這能把 team-composition-patterns 變成可靠的內部流程。

用 team-composition-patterns 做 Agent Orchestration 決策

當你要協調多條並行任務時，用這個技能標準化角色與能力，確保每條工作流都能搭配適當的 reviewer、debugger、implementer 與 lead agents。