SuperAPI AI 工具集

team-composition-patterns

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:为多智能体团队编成提供最佳实践,覆盖团队规模选择、智能体类型选择与显示模式配置,适用于 Claude Code 的 Agent Teams 功能。使用时机包括:决定为任务生成多少队友、在预设团队配置间选择、为角色挑选正确的 subagent_type、配置队友显示模式(tmux、iTerm2、in-process),以及搭建自定义团队。

团队规模启发式:简单任务 1-2 个(单一维度评审、孤立缺陷、小型功能);中等 2-3 个(多文件改动、2-3 类关注点);复杂 3-4 个(跨领域关注点、大型功能、深度调试);非常复杂 4-5 个(全栈功能、全面评审、系统性问题)。经验法则:从覆盖所有必要维度的最小团队开始,增加队友会提高协调开销。

预设配置:评审团队 3 个 team-reviewer,默认维度为安全、性能、架构;调试团队 3 个 team-debugger,3 个竞争性假设;功能团队 1 个 team-lead + 2 个 team-implementer;全栈团队 1 个 lead + 前端/后端/测试各 1 个 implementer;研究团队 3 个 general-purpose,各自负责不同研究问题;安全团队 4 个 team-reviewer,维度为 OWASP/漏洞、认证与访问控制、依赖与供应链、密钥与配置;迁移团队 1 个 lead + 2 个 implementer + 1 个 reviewer。

智能体类型选择:general-purpose 拥有全部工具,用于实现与调试;Explore、Plan 为只读,分别用于研究与架构规划;agent-teams:team-reviewer、team-debugger、team-implementer、team-lead 各自具备对应协调工具。关键区别:只读智能体不能修改文件,切勿派实现任务给只读智能体。

显示模式在 ~/.claude/settings.json 中配置 {"teammateMode": "tmux"},可选 tmux、iterm2、in-process。自定义团队建议:必须有协调者、角色匹配智能体类型、避免重复角色、预先界定边界、保持 2-4 人。

限制与排障:所有队友均无历史对话,初始提示需含完整上下文;tmux 模式需先安装并运行 tmux,否则用 in-process;评审维度重叠会重复发现问题,需重新划分;团队过大将拖慢协调。