mcpField
T
team-composition-patterns

team-composition-patterns

github.com/wshobsonAgent 工作流41.9k9.8k 次安装2 周前更新
代码仓库

关于 team-composition-patterns

为 Claude Code Agent Teams 提供多 Agent 团队组建指南，帮助按任务复杂度安排人数、角色和显示模式，并提供多种预设团队方案。

主要功能

  1. 01按复杂度估算团队规模
  2. 02提供代码评审与调试等预设团队
  3. 03按职责选择 Agent 类型
  4. 04配置队友显示模式
  5. 05制定自定义团队边界

适用场景

  1. 01规划代码评审的多维分工
  2. 02为多种根因假设安排并行调查
  3. 03拆分前后端与测试开发工作
  4. 04组织大型迁移的并行实施与审查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wshobson/agents --skill team-composition-patterns

安装后在 Claude Code 中输入/team-composition-patterns确认已加载。

附带文件references/agent-type-selection.mdreferences/preset-teams.md

详细介绍

团队组成模式

为 Claude Code 的 Agent Teams 功能编写多 Agent 团队、选择团队规模、挑选 Agent 类型以及配置显示模式的最佳实践。

何时使用本技能

  • 决定为某项任务生成多少名队友
  • 在预设团队配置之间进行选择
  • 为每个角色选择合适的 Agent 类型（subagent_type）
  • 配置队友显示模式（tmux、iTerm2、in-process）
  • 为非标准工作流构建自定义团队组成

团队规模参考准则

复杂度团队规模使用场景
简单1-2单一维度审查、孤立缺陷、小型功能
中等2-3多文件变更、2-3 个关注点、中型功能
复杂3-4跨领域关注点、大型功能、深度调试
非常复杂4-5全栈功能、全面审查、系统性问题

经验法则：从覆盖所有必需维度的最小团队开始。增加队友会提高协调开销。

预设团队组成

审查团队
  • 规模：3 名审查者
  • Agent：3x team-reviewer
  • 默认维度：安全性、性能、架构
  • 使用场景：代码变更需要多维度质量评估
调试团队
  • 规模：3 名调查者
  • Agent：3x team-debugger
  • 默认假设：3 个相互竞争的假设
  • 使用场景：缺陷存在多个可能的根本原因
功能团队
  • 规模：3（1 名负责人 + 2 名实现者）
  • Agent：1x team-lead + 2x team-implementer
  • 使用场景：功能可分解为并行工作流
全栈团队
  • 规模：4（1 名负责人 + 3 名实现者）
  • Agent：1x team-lead + 1x 前端 team-implementer + 1x 后端 team-implementer + 1x 测试 team-implementer
  • 使用场景：功能横跨前端、后端和测试层
研究团队
  • 规模：3 名研究者
  • Agent：3x general-purpose
  • 默认领域：各自分配不同的研究问题、模块或主题
  • 能力：代码库搜索（Grep、Glob、Read）、网页搜索（WebSearch、WebFetch）
  • 使用场景：需要理解代码库、研究库、比较方案，或并行从代码和网页来源收集信息
安全团队
  • 规模：4 名审查者
  • Agent：4x team-reviewer
  • 默认维度：OWASP/漏洞、认证/访问控制、依赖项/供应链、机密信息/配置
  • 使用场景：覆盖多个攻击面的全面安全审计
迁移团队
  • 规模：4（1 名负责人 + 2 名实现者 + 1 名审查者）
  • Agent：1x team-lead + 2x team-implementer + 1x team-reviewer
  • 使用场景：大型代码库迁移（框架升级、语言移植、API 版本升级），需要并行工作并进行正确性验证

Agent 类型选择

使用 Agent 工具生成队友时，应根据队友所需的工具选择 subagent_type：

Agent 类型可用工具适用场景
general-purpose所有工具（Read、Write、Edit、Bash 等）实现、调试、任何需要修改文件的任务
Explore只读工具（Read、Grep、Glob）研究、代码探索、分析
Plan只读工具架构规划、任务拆分
agent-teams:team-reviewer读取/搜索/Bash 以及 TaskList/TaskGet/TaskUpdate/SendMessage带结构化发现的代码审查
agent-teams:team-debugger读取/搜索/Bash 以及 TaskList/TaskGet/TaskUpdate/SendMessage假设驱动的调查
agent-teams:team-implementer读取/写入/编辑/搜索/Bash 以及 TaskList/TaskGet/TaskUpdate/SendMessage在文件归属边界内构建功能
agent-teams:team-lead读取/搜索/Bash 以及 Agent Teams 协调工具团队编排与协调

关键区别：只读 Agent（Explore、Plan）无法修改文件。切勿将实现任务分配给只读 Agent。

显示模式配置

在 ~/.claude/settings.json 中配置：

{
  "teammateMode": "tmux"
}
模式行为最适合
"tmux"每个队友位于一个 tmux 窗格开发工作流、监控多个 Agent
"iterm2"每个队友位于一个 iTerm2 标签页偏好 iTerm2 的 macOS 用户
"in-process"所有队友位于同一进程简单任务、CI/CD 环境

自定义团队指南

构建自定义团队时：

  1. 每个团队都需要一个协调者 — 要么指定一名 team-lead，要么由用户直接协调
  2. 让角色与 Agent 类型匹配 — 在可用时使用专用 Agent（reviewer、debugger、implementer）
  3. 避免角色重复 — 两个 Agent 做同一件事会浪费资源
  4. 预先定义边界 — 每个队友都需要对文件或职责有明确的归属
  5. 保持精简 — 2-4 名队友是最佳规模；5 名以上需要大量协调开销

故障排除

一名队友被创建为 Explore，但需要写入文件。 Explore 和 Plan 是只读 Agent。请将 subagent_type 改为 general-purpose 或合适的专用 Agent 类型。切勿将实现任务分配给只读 Agent。

团队规模增长过大，协调拖慢了所有工作。 每增加一名队友都会增加沟通开销。请合并角色：一个 Agent 能否覆盖两个维度？一个 4 人团队执行 6 项独立任务，通常不如 3 个 Agent 各覆盖 2 项任务。

tmux 模式没有显示窗格。 在创建队友之前，请确保已安装 tmux 且会话已在运行。in-process 模式无需 tmux 即可工作，适合 CI 或脚本化环境。

两名审查者报告了相同的问题。 审查维度存在重叠。请重新界定每位审查者的关注范围：一人负责正确性/逻辑，一人负责安全性，一人负责性能/可扩展性。重叠的覆盖会浪费 token 并产生重复的发现结果。

一个 team-lead 正在创建队友，但他们没有收到任务。 请确认该 lead 使用 Agent 工具创建队友，并在提示词中传递完整上下文。队友启动时没有任何先前对话历史——他们需要在初始提示词中获得所有相关信息。

相关技能

评论

支持 Markdown