Team 技能用于生成 N 个协调一致的代理,围绕一份共享任务清单协同工作,底层使用 Claude Code 的隐式智能体团队机制。
用途
Team 是 OMC 中负责并行、分阶段执行的权威机制。它把用户给出的高层任务分解为多个子任务,分派给多个队友代理,并通过验证与修复循环推动任务收敛。
主要能力
- 按数量生成队友代理:N 取值为 1-20,可省略,省略时根据任务分解自动确定规模。
- 指定代理类型:例如 executor、debugger、designer、codex、gemini、antigravity 等;省略时按阶段感知路由选择。
- 使用共享任务清单管理子任务及其依赖关系。
- 分阶段流水线:team-plan → team-prd → team-exec → team-verify → team-fix(循环)。
- 阶段间通过手写 handoff 文档传递已决策事项、被否决方案、风险和剩余事项。
- 可选结合 Ralph 持久性循环(失败重试、完成前由架构师验证)。
- 支持通过 Codex CLI、Gemini CLI、Antigravity CLI 执行的工作代理(需相应 CLI 已安装)。
使用方式
命令形式:
- /oh-my-claudecode:team N:agent-type "task description"
- /oh-my-claudecode:team "task description"
- /oh-my-claudecode:team ralph "task description"
示例(来自资料原文):
- /team 5:executor "fix all TypeScript errors across the project"
- /team 3:debugger "fix build errors in src/"
- /team 4:designer "implement responsive layouts for all page components"
- /team "refactor the auth module with security review"
- /team ralph "build a complete REST API for user management"
- 使用 Codex CLI worker(需先安装:npm install -g @openai/codex):/team 2:codex "review architecture and suggest improvements"
- 使用 Gemini CLI worker(需先安装:npm install -g @google/gemini-cli):/team 2:gemini "redesign the UI components"
- 使用 Antigravity CLI worker(需按 https://antigravity.google 安装):/team 2:antigravity "redesign the UI components"
运行机制
在 Claude Code 2.1.178+ 中,原生的 TeamCreate/TeamDelete 已被移除;开启 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 后,每个会话拥有一个隐式团队,队友通过 Agent/Task 工具以不同的 name 值直接生成。本技能仍保留 OMC 旧有的 tmux/CLI worker 编排(omc team / /omc-teams)。隐式团队与 omc team 不共享结果:一方完成不代表另一方成功。swarm 兼容别名已在 #1131 中移除。
阶段代理路由:由主导代理按阶段和任务特征选择代理,用户的 N:agent-type 参数只覆盖 team-exec 阶段的 worker 类型。
验证/修复循环:持续执行 team-exec → team-verify → team-fix,直到验证通过且没有必需的修复任务,或工作达到明确的终止性阻塞/失败结果。team-fix 有最大尝试次数限制,超过则转为终止性失败,不会无限循环。
恢复与取消:从最后一个非终止阶段恢复,读取 .omc/handoffs/ 以还原阶段转换上下文;取消遵循 skills/cancel/SKILL.md 的权威流程,.omc/handoffs/ 中的 handoff 文件会保留以便恢复。终止状态为 complete、failed、cancelled。
适用场景
需要将大型或可并行的任务(如批量修复 TypeScript 错误、修复构建错误、实现响应式布局、重构模块并附带安全审查、构建完整 REST API 等)拆解并交由多个协调代理完成时。
限制
- 原生 Claude Code 不再创建每个团队的 ~/.claude/teams/<name>/ 目录,也不提供 TeamCreate/TeamDelete 调用;team_name 仅作为被忽略的旧版元数据被接受,不应用于路由。
- tmux CLI worker 不参与 Claude 的原生团队消息传递。
- 使用 codex、gemini、antigravity worker 需先安装相应 CLI。
- 在原生 Windows 上,需先检查 tmux 兼容二进制(如 psmux);只有确实没有可用的 tmux 兼容二进制时,才建议安装 psmux 或使用 WSL2。
- 费用、价格、平台等具体信息暂未提供。