Claude Code 多 agent 协作：协调者模式实战指南

你用 Claude Code 多久了？如果只让它一个人干所有活，那真的是大材小用了。

今天挖到一个让我眼前一亮的 Skill——multi-agent-orchestration，专门教你用 Claude Code 的内置编排能力，把一个任务拆给多个「小 agent」并行干，最后再汇总结果。相当于给 Claude 配了一支小队。

核心玩法：协调者模式

这个 Skill 教你的核心架构叫「协调者模式」：

协调者（限制工具）→ 背景 worker A / B / C 并行工作 → 协调者汇总

协调者只保留三个工具：Agent（生成 worker）、SendMessage（发消息）、TaskStop（停止）。自己不动手，只负责指挥。

实际工作流是怎样的？

第一步：研究阶段 — 同时启动 3 个 Explore agent 查资料，各自独立工作：

• A：调研认证库的 API
• B：读取现有的用户模型和数据库 schema
• C：检查现有测试的写法

三个并行跑，总耗时 ≈ 最慢那个的时间。

第二步：综合 — 协调者读取三份调研结果，形成统一认知。比如：「库用的是 JWT，schema 有 email/password_hash，测试用 vitest 的 factory 模式……」

第三步：实施 — 把综合后的方案传给实现 agent，带上具体指令，而不是直接甩调研报告。

第四步：验证 — 再起一个 agent 跑测试，确认功能正常。

关键原则：协调者必须先「消化」再传递，直接把调研结果甩给实现 agent 是大忌。

安装方法

把仓库装到本地即可（用户全局 ~/.claude）：

git clone https://github.com/pfangueiro/claude-code-agents.git
cd claude-code-agents
./install.sh

Skill 名是 multi-agent-orchestration，触发关键词包括：multi-agent、orchestrate、team、coordinator、parallel agents、worker agents、background agent、agent swarm。

两个实战技巧

1. 背景执行不阻塞

Agent: {
  description: "读取 schema",
  prompt: "...",
  run_in_background: true
}

加了 run_in_background: true，worker 在后台跑，协调者保持响应，可以同时起多个。

2. Fork 模式省 token

不加 subagent_type 的 Agent 调用就是 fork——复用了协调者自己的 prompt cache，比重新初始化一个 worker 便宜得多。什么时候用 fork？worker 需要协调者上下文（对话历史、前期调研）时直接 fork；worker 自成一个独立任务时就起 fresh agent。

适用场景

适合需要深度调查、多模块并行开发、或者任务规模超出单个 context 上限的场景。一个 agent 干 30 分钟的活，拆成 3 个 worker 并行，5 分钟跑完。

GitHub 仓库里有 13 个自动激活的 SDLC 专精 agent + 27 个 Skill，安装一次，每个项目都能用，是一个值得放进常用堆的底层框架。

GitHub：https://github.com/pfangueiro/claude-code-agents

GitHub: https://github.com/pfangueiro/claude-code-agents