KimYx0207 / agent-teams-playbook
agent-teams-playbook
Cross-runtime Agent Teams orchestration playbook for Claude Code, Codex, OpenClaw, and Cursor. This skill should be used when the user asks to "create agent teams", "use agent swarm", "setup multi-agent collaboration", "orchestrate agents", "coordinate parallel agents", "organize team collaboration", "build agent teams", "implement swarm orchestration", "setup multi-agent system", "coordinate agent collaboration", or needs guidance on adaptive team formation, quality gates, skill discovery, task distribution, team coordination strategies, or Agent Teams best practices. 或者当用户说"多agent"、"agent协作"、"agent编排"、"并行agent"、"分工协作"、"拉团队"、"拉个团队"、"多代理协作"、"swarm编排"、"agent团队"时也应使用此技能。Note: "swarm/蜂群" is a generic industry term; Claude Code's official concept is "Agent Teams"; Codex, OpenClaw, and Cursor should map this playbook to their native or host-provided agent capabilities without deleting any workflow stage.
作为 Agent Teams 协调器，你的职责包括：明确每个角色的职责边界、把控执行过程、对最终产品质量负责。
> 核心理解（铁律）：Agent Teams 是"并行处理 + 结果汇总"模式，不是扩大单个 agent 的上下文窗口。每个 teammate 是独立的执行单元，拥有独立上下文，可以并行处理大量信息，但最终需要将结果汇总压缩后返回主会话。
跨平台兼容层（新增，不替代原流程）
本 Skill 的完整 6 阶段工作流、按需能力解析、Agent → Skill 委派模式、质量把关和故障处理规则仍然保留。四个平台的差异只影响"用什么工具执行"，不影响"是否执行这些阶段"。
先识别当前平台，再把下列抽象动作映射到平台原生能力。不要在非 Claude Code 平台原样承诺 Task、TeamCreate、SendMessage 或 Skill(...) 一定存在；也不要因为平台工具名不同而跳过阶段0-5。
| 抽象动作 | Claude Code | Codex | OpenClaw | Cursor |
|---|---|---|---|---|
| 调用 Skill | Skill(skill="name", args="...") 或 slash skill | 读取并遵循本地 skill 指令；只有宿主暴露 skill 工具时才称为"调用" | 读取并遵循 openclaw/skills 或全局 skill；按 OpenClaw 当前工具执行 | 读取并遵循 .cursor/skills 或全局 skill；按 Cursor 当前 agent 能力执行 |
| 启动独立 Subagent | 使用宿主当前暴露的 Agent / Task，至少携带必填 prompt，并按当前 schema 提供 subagent_type、description/name 和边界 | 使用顶层 spawn_agent(task_name, message, fork_turns) | workspace / agent 调度能力；不可用则主线程分阶段执行 | background agent / agent mode；不可用则主线程分阶段执行 |
| 组建 Agent Team | 宿主暴露时使用 TeamCreate + Agent / Task(team_name) | 同一轮并发调用多个顶层 spawn_agent，由主线程汇总；不伪装共享团队总线 | team / workspace 能力存在时使用；否则多个任务或主线程 | background agents / team-like workflow 存在时使用；否则多个任务或主线程 |
SKILL.md