team-composition-patterns

team-composition-patterns 技能概览

team-composition-patterns 是为 Claude Code Agent Teams 设计多智能体团队的决策型技能，覆盖团队规模启发式、agent 类型选择与展示模式取舍。它更适合需要可复用团队配置的构建者，用于评审、调试或功能交付，而不是临时“随便拉几个人”的提示词。

team-composition-patterns 能帮你做的决策

它解决三个落地阻碍：用多少个 agent、每个角色匹配哪个 subagent_type、以及在你的环境中选哪个显示模式（tmux、iTerm2、in‑process）。

最适合的场景与预期结果

当你需要在代码评审、问题排查或功能实现中保持一致的团队构成，且希望复用预设团队而不是每次重新分工时，就该用它。

相比通用提示词的差异点

与泛泛的“创建一个团队”提示不同，该技能固化了规模启发式、预设配置，以及与 agent 能力绑定的 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 本地）、以及是否需要写权限。这些会直接映射到团队规模与 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。

优先应用预设团队组合

评审/调试的预设团队是最快见效的路径，包含角色分工、关注维度与结构化任务模板，保证每个 agent 有清晰职责与输出格式。

根据环境选择展示模式

需要多输出并能接受终端分屏时，推荐 tmux。轻量场景可用 iTerm2 或 in‑process，减少摩擦。

team-composition-patterns 的建议工作流

1. 归类任务与复杂度。
2. 基于维度选择预设或自定义团队。
3. 为每个角色分配 subagent_type。
4. 根据环境选择展示模式。
5. 给每位队友提供结构化任务模板。

team-composition-patterns 技能常见问题

team-composition-patterns 只适用于 Claude Code Agent Teams 吗？

是的。它围绕 subagent_type 与显示模式等 Agent Teams 概念设计，没有该环境时建议难以落地。

它和普通“创建团队”提示有什么不同？

它提供团队规模决策规则、agent 类型选择矩阵，以及带任务模板的预设团队，这些都是通用提示通常缺失的。

适合新手吗？

适合，只要你跟着预设团队走。决策矩阵可能略密，但能避免常见错误，比如把写权限交给仅探索的 agent。

什么时候不该用？

一次性、低风险的任务只需一个通用 agent 时就别用，协作成本可能超过收益。

支持迁移或审计这类自定义流程吗？

支持。技能明确覆盖非标准流程，你可以通过组合维度并选合适的 subagent_type 角色来搭建自定义团队。

如何改进 team-composition-patterns 技能使用效果

提供更清晰的任务维度以优化团队设计

明确评审维度（安全、性能、架构、测试）。维度清晰可映射到预设评审角色并减少重叠。

避免常见失败模式

失败模式：选错 subagent_type（例如需要改代码却用 Plan）。修复方法是明确是否需要写文件，并使用决策矩阵。

用更强的输入上下文提升输出

加入范围提示如 “multi-file change”“cross-cutting concern”“CI-only environment”。这些会影响推荐团队规模与展示模式。

在第一次团队建议后迭代

如果结果偏浅，加一个缺失维度（如可访问性）或把团队规模加一人；如果输出冗余，就缩小范围或减少人数。

为你的组织创建可复用模板

把 references/preset-teams.md 的任务模板适配到你们仓库习惯（文件路径、输出格式、严重程度分级），把 team-composition-patterns 变成稳定的内部流程。

用 team-composition-patterns 做 Agent Orchestration 决策

当需要并行推进多条任务流时，用该技能标准化角色与能力，确保每条流都有合适的 reviewer、debugger、implementer 与 lead 组合。