A community-driven registry for Claude, Cursor, Windsurf, Cline & more. Not affiliated with Anthropic.
Are you the author? Sign in to claim
Claude Code多智能体编排Skill：自适应决策 + 6阶段工作流 + 5大场景 | Multi-agent orchestration skill for Claude Code
老金的开源知识库，实时更新群二维码：https://my.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf
获取更多AI资讯和技术支持
微信公众号：获取AI第一信息 | 个人微信号：备注'AI'加群交流
如果这个教程对你有帮助，欢迎打赏支持！
微信支付 |
支付宝 |
agent-teams-playbook 是一个跨运行时 Skill，用于生成可执行的多代理（Agent Teams）编排策略，兼容 Claude Code、Codex、OpenClaw、Cursor 四个平台。
核心理解："swarm/蜂群"是通用行业说法，Claude Code的官方概念是 Agent Teams。其他运行时不一定有同名工具，但可以用各自的 subagent/background-agent/workspace 能力实现同一套"并行外脑 + 汇总压缩"编排合同。Agent Teams 不是"单脑扩容"——并行读取/处理的总量可以很大，但回到主会话仍需总结压缩。
核心思想是"自适应决策"，而不是"写死配置"。面向真实运行环境中的不确定性：
自然语言触发词：
Skill命令（Claude Code 或支持 slash skill launcher 的运行时）：
/agent-teams-playbook [任务描述]# 克隆仓库
git clone https://github.com/KimYx0207/agent-teams-playbook.git
# 运行安装脚本（Unix / Git Bash / WSL）
cd agent-teams-playbook
chmod +x scripts/install.sh
# 安装到 Claude Code（默认）
./scripts/install.sh
# 安装到指定平台
./scripts/install.sh --target codex
./scripts/install.sh --target openclaw
./scripts/install.sh --target cursor
# 一次安装到四个平台
./scripts/install.sh --target all
# 从 GitHub main 下载安装，而不是复制当前本地 checkout
./scripts/install.sh --target all --from-github
# Claude Code
mkdir -p ~/.claude/skills/agent-teams-playbook
cp SKILL.md ~/.claude/skills/agent-teams-playbook/
cp README.md ~/.claude/skills/agent-teams-playbook/
# Codex
mkdir -p ~/.codex/skills/agent-teams-playbook
cp SKILL.md ~/.codex/skills/agent-teams-playbook/
cp README.md ~/.codex/skills/agent-teams-playbook/
# OpenClaw（默认全局 skill 根目录；项目也可使用 openclaw/skills/）
mkdir -p ~/.agents/skills/agent-teams-playbook
cp SKILL.md ~/.agents/skills/agent-teams-playbook/
cp README.md ~/.agents/skills/agent-teams-playbook/
# Cursor
mkdir -p ~/.cursor/skills/agent-teams-playbook
cp SKILL.md ~/.cursor/skills/agent-teams-playbook/
cp README.md ~/.cursor/skills/agent-teams-playbook/
安装脚本支持通过环境变量覆盖目标根目录：
| 平台 | 环境变量 | 默认目录 |
|---|---|---|
| Claude Code | CLAUDE_SKILLS_DIR | ~/.claude/skills |
| Codex | CODEX_SKILLS_DIR | ~/.codex/skills |
| OpenClaw | OPENCLAW_SKILLS_DIR | ~/.agents/skills |
| Cursor | CURSOR_SKILLS_DIR | ~/.cursor/skills |
安装完成后，你可以通过以下方式使用：
# Claude Code 使用 Skill 命令
/agent-teams-playbook 我的任务描述
# 或使用自然语言
帮我组建一个Agent团队来完成这个任务...
# Codex / OpenClaw / Cursor
# 使用自然语言触发；运行时会按各自平台工具映射执行
帮我拉一个 agent team 来审查这个重构方案
本 skill 优先复用以下通用 skill，但不再把它们写成所有平台的硬依赖。原因是 Codex、OpenClaw、Cursor 的 skill 调用机制和可见目录可能不同；当依赖不可用时，应使用该平台的计划工具或主线程降级执行。
| Skill | 用途 | 调用阶段 |
|---|---|---|
| planning-with-files | Manus风格文件规划系统，创建task_plan.md、findings.md、progress.md | 阶段0（所有场景必经） |
| find-skills | 外部skill搜索和发现，扩展本地skill库 | 阶段1（Skill回退链） |
降级原则：依赖存在就调用；不存在就显式说明降级方式，继续用当前平台可用的 plan / search / agent 工具完成编排。
| # | 场景 | 适用条件 | 核心策略 |
|---|---|---|---|
| 1 | 提示增强 | 简单任务，1-2步 | 优化单agent提示词，不拆分不组队 |
| 2 | Skill直接复用 | 任务可由单个Skill完全解决 | 执行规划和Skill搜索后，直接调用匹配的Skill，无需组建Agent Teams |
| 3 | 计划+评审 | 中等/复杂任务（默认） | 出计划 → 按宿主审批规则执行 → Review验收 |
| 4 | Lead-Member | 需要明确团队分工 | Leader协调分配，Member并行执行 |
| 5 | 复合编排 | 复杂任务，无固定模式 | 动态组合上述场景，按阶段切换策略 |
阶段0：规划准备 → 阶段1：任务分析+Skill发现 → 阶段2：团队组建 → 阶段3：并行执行 → 阶段4：质量把关 → 阶段5：结果交付
注意：阶段0（规划准备）和阶段1（能力发现）是所有场景的强制前置步骤。优先调用
planning-with-files/find-skills，但如果当前平台没有对应 skill/tool，必须明确降级而不是假装已经调用。
每个阶段：输出计划 → 执行 → 输出结果。任务拆分计划按宿主审批规则和用户指令执行；需要确认时先确认。
| 模式 | 通信方式 | 适用场景 | Claude Code | Codex | OpenClaw / Cursor |
|---|---|---|---|---|---|
| Subagent | 子agent → 主协调器单向汇报 | 并行独立任务 | Task | 宿主提供的 subagent/custom-agent dispatch；否则降级 | 平台 agent/background 能力 |
| Agent Team | 成员间可双向通信 | 需要协作的复杂任务 | TeamCreate + Task(team_name) | 多个独立 subagent + 主线程协调；仅在宿主暴露 agent I/O 时中途交互 | 平台 team/workspace 能力；没有则降级 |
子 Agent 调用 Skill 有3种模式。Claude Code 可直接使用 Skill 工具；Codex、OpenClaw、Cursor 需要先确认当前运行时是否提供等价 skill 调用能力。没有等价工具时，按 skill 文档内联执行或降级为主线程处理。
协调器自己调用Skill工具，不经过子Agent。适合单步Skill任务、不需要并行的场景。
用户 → 协调器 → Skill tool → 结果返回给用户
协调器通过当前平台 subagent 工具生成子 Agent，在任务说明中注入 Skill 调用指令，子 Agent 执行 Skill 并汇报结果。适合需要并行多个 Skill、或 Skill 执行耗时较长的场景。
协调器 → subagent(prompt="请使用 /skill-name 完成 X") → subagent → Skill/tool 或内联执行 → 结果汇报
关键点：任务说明中写明要调用的 Skill 名称和参数；只有平台支持 skill 工具时才承诺自动调用。
通过当前平台团队能力组建团队，成员在协作过程中按需调用 Skill。适合长期运行、需要成员间协调的复杂任务。Claude Code 使用 TeamCreate；Codex 使用宿主提供的 subagent/custom-agent 能力加主线程协调；OpenClaw/Cursor 使用各自 team/workspace/background-agent 能力，不可用时降级。
协调器 → team/subagents → 分配任务 → member → Skill/tool 或内联执行 → 汇报
| 场景 | 推荐Pattern | 原因 |
|---|---|---|
| 单个Skill任务 | Pattern 1 | 最简单，无额外开销 |
| 并行多个Skill | Pattern 2 | 平台提供并发 subagent 时可并行 |
| 需要成员间协作 | Pattern 3 | 平台提供 team messaging 时可双向通信 |
| Skill执行后需要后续处理 | Pattern 2/3 | subagent可以处理Skill输出 |
agent-teams-playbook/
├── SKILL.md # 运行时加载（完整执行协议 + 跨平台适配层）
└── README.md # 开发者文档（完整说明）
关键区别：
SKILL.md 运行时加载，必须精简，避免不必要 token 消耗README.md 给人看的文档，可以写完整说明| 平台 | 支持级别 | 说明 |
|---|---|---|
| Claude Code | 原生 | 可使用 Skill、Task、TeamCreate、SendMessage 等 Agent Teams 语义 |
| Codex | 适配 | 使用宿主提供的 subagent/custom-agent dispatch 与 agent I/O；不可用时降级为主线程分阶段执行，没有真正 TeamCreate 总线 |
| OpenClaw | 适配 | 使用 OpenClaw workspace/team/skill 能力；能力缺失时降级为分阶段执行 |
| Cursor | 适配 | 使用 Cursor agent/background-agent 和 .cursor/skills；能力缺失时降级为分阶段执行 |
重要边界：四个平台能力不完全等价。本 skill 的稳定部分是"编排合同"：先澄清目标、再能力发现、再团队蓝图、再执行/评审/验证。具体工具名必须由运行时适配层决定。
Claude Code 默认不设置 context: fork，6阶段工作流在主会话中执行，用户可以看到每个阶段的完整输出，并在阶段1确认计划后再执行。
如果你希望隔离上下文（避免编排过程占用主会话上下文窗口），可以手动在SKILL.md的frontmatter中添加：
---
name: agent-teams-playbook
version: "4.7"
context: fork # 添加这行启用隔离模式
---
| 模式 | 6阶段可见 | 用户可确认计划 | 上下文隔离 | 适合场景 |
|---|---|---|---|---|
| 默认（无fork） | ✅ 完全可见 | ✅ 可以 | ❌ 共享主会话 | 需要看到完整流程、需要确认计划 |
| fork模式 | ❌ 仅看到最终结果 | ❌ 自动执行 | ✅ 隔离执行 | 信任Skill决策、节省主会话上下文 |
本 Skill 不会：
更新本 Skill 时：
SKILL.md 保持精简、只保留执行必需信息版本：V4.7 最后更新：2026-04-30 维护者：老金
npx CLI installing 100+ agents, commands, hooks, and integrations in one command
干净、强大、属于你的 AI Agent 平台 --AI agents, without the clutter.
Native macOS app to monitor Claude AI usage limits and watch your coding sessions live
Pocket Flow: Codebase to Tutorial