一个 Claude Code 编排型 skill:一条命令拉起多 Agent 团队,把跨文件重构 / 大规模审查 / 多角色协作等复杂任务,拆成 6 步自动跑完。编排 Claude Code 原生 Agent 工具,自己不实现业务逻辑。
对应教程:阶段 5 推广度量 · 多 Agent 并行。
agent-teams 是「多 Agent 编排器」:你说一句”拉个团队做 XX”,它走 6 步——环境检测 → 分析蓝图 → 🔴确认 → 并行执行 → 质量验收 → 结果交付——把任务派给一组子 Agent 并行干完,验收合格才交付。
它自己不写业务逻辑,只做三件事:组队(按团队模板拆角色)、调度(按依赖拓扑并行派 Agent)、把关(5 个确认点 + 质量验收打回闭环)。
这是编排型 skill——学它的价值在 4 个设计手法:①编排不实现 ②人在回路确认闸门 ③项目注册表跨项目复用 ④优雅降级。
| 依赖 | 必需? | 说明 |
|---|---|---|
| Claude Code(Agent 工具) | ✅ 必需 | 提供 subagent 调度、Skill 加载 |
| Swarm 协作 | ⚪ 可选 | 设环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1;不设自动回退标准并行 |
| devflow skill | ⚪ 可选 | 装了可联动 devflow 的 Stage 4;不装走独立模式 |
| bash + python3 | ✅ 自检 | 仅 verify.sh 用,标准库即可 |
诚实声明:核心 6 步流程在标准 Claude Code 可跑;Swarm / devflow 集成为可选增强,取决于你的环境——不承诺所有功能在所有环境全跑通。每个可选依赖都有自动回退(见
SKILL.md「降级规则」)。
把整个目录复制到自己项目的 .claude/skills/agent-teams/。
Mac / Linux:
cp -r demos/agent-teams /your-project/.claude/skills/agent-teams
Windows(或直接用资源管理器拖文件夹):
xcopy /E /I demos\agent-teams your-project\.claude\skills\agent-teams
可选:把 settings.json 的 permissions / env 合并进你项目的 .claude/settings.json(启用 Swarm 记得把 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 改 1)。
装好在项目根启动 Claude Code,然后:
/agent-teams 开发用户认证功能,含注册登录页和后端 JWT 接口
或自然语言(命中关键词即可):「帮我拉个团队做 XX」「多 agent 并行重构 XX」「跨项目加个 XX 功能」。
完整对话样例见 examples/blueprint-example.md,通读手册见 manual.md。
bash demos/agent-teams/scripts/verify.sh
检查:frontmatter 合法 / 必需文件齐全 / 注册表 JSON 可解析。退出码 0 = 包完整、可被 Claude Code 加载;1 = 有缺失,会打印缺什么。
.claude/skills/agent-teams/ → 启动 Claude Codeagent-teams/
├── SKILL.md # Skill 入口(AI 读):frontmatter + 6 步 + 策略 + 降级
├── manual.md # 人话操作手册(你读)
├── settings.json # 配置样例(权限 / Swarm 开关)
├── reference/ # 按需加载(AI 细节)
│ ├── orchestration.md # 4 策略 + Swarm + devflow 集成
│ └── team-and-registry.md # 团队模板 + 模型速查 + 注册表
├── examples/
│ ├── project-registry.json # 注册表示例
│ └── blueprint-example.md # 标准并行完整样例
└── scripts/
└── verify.sh # 自检
三件套:SKILL.md(入口)+ reference/(按需细节)+ examples/(样例)。这是 Claude Code skill 的标准组织:frontmatter 常驻上下文、正文按需读取、细节渐进披露。
demos/claude-skills/ 是单 skill 仓库(devflow / sql-query / crud-gen / code-review),agent-teams 是多 Agent 编排层,体量与定位不同,所以独立成包。best-practices.md)。