dispatching-parallel-agents

dispatching-parallel-agents 快速入门

让多个 AI Agent 同时干活,把 1 小时的工作压成 5 分钟。

这是什么?解决什么问题?

串行让 AI 干活是大家最熟悉的方式:问一个问题,等回答,再问下一个。但实际工程里,有些任务完全可以并发——比如”为 3 个模块各自补测试”、“为 5 个 API 各自写文档”、“对 10 个组件各自做 Code Review”。串行做就是 1 倍时间,并行做可以接近 1/3 ~ 1/10。 dispatching-parallel-agents 是 Obra Superpowers 套件中的并发任务分发 Skill。它解决的问题是:当一个父 Agent 收到一个可拆解的大任务时,如何把它”切片”成多个子任务,把每个子任务派发给独立的 Agent 实例(或独立的 LLM 上下文窗口),最后把结果汇总回来。 Skill 内部封装了:任务切分(哪些可以并行、哪些有依赖)、结果合并(怎么把多个子任务输出聚合成最终答案)、失败处理(某个子 Agent 崩了怎么办)、上下文隔离(每个子 Agent 看到的是不同的代码片段,不会互相污染)。Obra 团队建议并行数控制在 5-30 之间,太多反而会因为协调开销而变慢。 适合:大型 monorepo 项目、需要批量处理多模块任务、希望把 AI 编程效率”按核数线性扩展”的工程团队。

准备工作

1. Claude Code 或其他支持子 Agent 的客户端
2. Obra Superpowers 套件:本 Skill 是其中之一
3. Git 项目:方便 AI 按模块/目录切分任务
4. 可并行的工作量:至少 3 个独立子任务才有意义

3 步快速上手

第 1 步:安装 Skill

npx skills add obra/superpowers --skill dispatching-parallel-agents

仓库:https://github.com/obra/superpowers

第 2 步:验证 Skill

向 AI 询问:

用 dispatching-parallel-agents Skill,解释一下什么样的任务适合并行分发

如果 AI 提到了”无强依赖”、“可独立验证”、“相同模板不同数据”等关键词,说明 Skill 加载成功。

第 3 步:实际分发一个并行任务

请用 dispatching-parallel-agents Skill,把 src/api/ 下 3 个文件
(orders.ts / users.ts / products.ts)各自分发一个子 Agent,
让它们各自写一份 README.md 文档

父 Agent 会拆出 3 个子任务,每个子 Agent 独立读文件、写文档,最后父 Agent 把 3 份结果汇总成总览。

常见踩坑

1. 子任务粒度太细:把”写一个函数”派给子 Agent,启动开销远大于实际工作。建议每个子任务至少 5-10 分钟工作量。
2. 子任务互相依赖:A 子 Agent 的输出是 B 的输入,这不是并行而是串行场景,不要硬派发。Skill 会主动识别并提示”这两个有依赖,应该串行”。
3. 上下文溢出:每个子 Agent 上下文独立,如果每个都要读整个 monorepo,token 消耗大。要让 Skill 用”局部读取 + 接口约定”减少上下文。
4. 结果合并冲突:3 个子 Agent 都修改了同一个文件 index.ts,父 Agent 合并时冲突。务必在指令里规定”每个子任务只动自己模块的文件,不要碰公共文件”。
5. 失败子 Agent 没重试:某个子 Agent 因为网络/API 限流失败,父 Agent 不知道,任务”静默挂掉”。Skill 默认有重试机制,但要配置 max_retries=3。
6. 顺序依赖被忽略:测试需要在实现后跑,迁移需要在部署前做——这些场景不能并行。Skill 会自动识别,但显式说”X 必须在 Y 之后”更稳。

初级用法

1. 批量文档生成:为 10 个 API 端点各生成一份文档,模板相同,数据独立,典型并行场景。
2. 多模块测试补充:为 monorepo 里 5 个子包各自补单元测试,每个子包由独立 Agent 处理。
3. 批量翻译:把 30 段文案分给 5 个子 Agent,每 Agent 处理 6 段,4-5 倍提速。

高级玩法

1. Map-Reduce 模式:父 Agent 把任务 Map 成 N 个子任务,所有子 Agent 完成后 Reduce 结果。适合做”全代码库搜索 + 汇总”。
2. 优先级调度:对紧急任务用更多子 Agent(资源倾斜),对长尾任务少派 Agent(节省 token)。
3. 失败隔离 + 回退:某个子 Agent 持续失败,自动降级为”只标记位置不修复”,让其他子任务继续推进。

小技巧

• 设定合理的 max_concurrent=5,太多会触发 LLM API 限流。
• 子 Agent 共享一个 task_id,方便日志追溯哪个子任务由谁派发。
• 在父 Agent 指令里加”每个子任务输出必须包含模块名 + 文件路径 + 摘要”,便于合并。
• 大文件读全文前先让 AI 写 grep 关键词,减少上下文占用。
• 用 git worktree 给每个子 Agent 独立工作区,避免文件系统竞争。
• 监控 token 消耗,Obs 超大任务考虑分批,而不是一次性派 30 个子 Agent。

参考链接

• Skill 仓库
• Obra 团队博客
• Anthropic 官方子 Agent 文档(适用于 Claude Code)
• MapReduce 论文(经典思路)
• 并行 AI Agent 模式综述