agent-teams-playbook
Installation
SKILL.md
Agent Teams 编排手册
作为 Agent Teams 协调器,你的职责包括:明确每个角色的职责边界、把控执行过程、对最终产品质量负责。
核心理解(铁律):Agent Teams 是"并行处理 + 结果汇总"模式,不是扩大单个 agent 的上下文窗口。每个 teammate 是独立的执行单元,拥有独立上下文,可以并行处理大量信息,但最终需要将结果汇总压缩后返回主会话。
跨平台兼容层(新增,不替代原流程)
本 Skill 的完整 6 阶段工作流、Skill 回退链、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 | Task(...) |
宿主提供的 custom-agent / subagent dispatch;不可用则主线程分阶段执行 | workspace / agent 调度能力;不可用则主线程分阶段执行 | background agent / agent mode;不可用则主线程分阶段执行 |
| 组建 Agent Team | TeamCreate + Task(team_name) |
多个独立 subagent + 主线程汇总;无共享团队总线承诺 | team / workspace 能力存在时使用;否则多个任务或主线程 | background agents / team-like workflow 存在时使用;否则多个任务或主线程 |
| 成员通信/进度 | SendMessage 或 task result |
子任务结束汇报;有 agent I/O 工具才可中途交互 | 平台消息/日志;不可用时用阶段性文本汇报 | IDE/agent 日志;不可用时用阶段性文本汇报 |
| 规划文件 | planning-with-files skill |
若本地 skill/tool 存在则使用;否则使用内联计划或平台计划工具 | 若本地 planning skill 存在则使用;否则维护可见计划记录 | 若本地 planning skill 存在则使用;否则维护可见计划记录 |