分包给谁：多Agent协作件横评

概述

本期是工作流自动化系列的收官方向：多Agent协作。此前部署、CI、监控、编排各工位都已逐一盘点过，唯独「一个人干不完、分包给几个Agent一起干」这件事还没系统拆过。本期选了生态里五种有代表性的协作范式——蜂群制（claude-flow）、兵种库制（wshobson/agents）、教材化兵种库（VoltAgent子Agent合集）、剧本制（BMAD-METHOD）、人格切换制（SuperClaude）——横向评测，并把兵种库制的代表拆到子Agent定义文件逐段讲解，最后提炼一套「任务书五要素」交接协议，读者看完可以直接照着给自己的项目写子Agent。

先说核心发现：多Agent协作件的竞争焦点已经从「能派多少个Agent」转移到「交接协议写得有多严」——派活谁都会，收工不失联的没几家。

生态全景

mindmap
  root((多Agent协作件))
    蜂群制
      claude-flow
      皇后调度加群体记忆
    兵种库制
      wshobson agents
      一文件一兵种
    教材化兵种库
      VoltAgent子Agent合集
      按门类成套供应
    剧本制
      BMAD-METHOD
      规划与开发两阶段流水线
    人格制
      SuperClaude
      一个Agent分饰九角

四种范式的分工逻辑完全不同：蜂群制靠一个调度中心动态分配；兵种库制靠描述字段静态匹配；剧本制把协作流程写死成阶段剧本；人格制干脆不拆Agent，让同一个Agent换帽子。下表先给出总评分。

评测对比表

注：上手难度星级越高表示越容易上手。本表为定性评估，基于各仓库公开文档与社区长期反馈综合判断，未给出具体星数等精确数值。

五个件逐一过堂

claude-flow：蜂群制，野心最大的那一台

定位：给 Claude Code 装一套完整的蜂群操作系统——一个调度核心（蜂后）把目标拆给一群工蜂Agent并行执行，附带跨会话的群体记忆和上百个配套工具。

亮点：它是「编排强度」的上限样本。目标一句话进去，蜂后负责拆解、派发、回收，工蜂各自只看自己的任务书；记忆层让多次会话之间能续上状态，不用每次从零交代。对大规模重构、多模块并行开发这类真·大活，这种建制是单Agent序列作业追不上的。

短板：装机成本和心智成本都高。初始化会往项目里铺一层配置，命令面很宽，新手容易「装完不知道第一句说什么」。token 消耗也明显放大——每个工蜂都要带一份自己的上下文，账单是按兵种数量乘上去的。

安装（摘自仓库 README）：

npx claude-flow@latest init
npx claude-flow@latest swarm "你的目标描述"

wshobson/agents：兵种库，把派活做成静匹配

定位：一套按职业分工预制的子Agent定义文件集合——后端架构师、前端工程师、运维架构师、安全审计员等几十个兵种，一个 .md 文件一个兵，复制进 ~/.claude/agents/ 即可让主Agent按需点将。

亮点：设计质量是这一期最高的。它的每个兵种文件都遵守同一套格式纪律：frontmatter 三个字段（名字、描述、工具白名单），正文是一份完整的岗位说明书。主Agent派活不靠额外调度器，靠描述字段自动匹配——你在对话里说「帮我设计一个 API」，后端架构师就自动被请出来。零运行时、零依赖，纯文本协议，可移植性拉满。

短板：兵种是静态的，协作也是一次性的——主Agent派一个兵干完收工，兵与兵之间没有横向沟通，复杂项目仍要主Agent自己串场。另外兵种库大了以后，描述字段之间会打架，匹配精度随库容递减。

安装：

git clone https://github.com/wshobson/agents
cp agents/*.md ~/.claude/agents/

VoltAgent 子Agent合集：教材化的成套供应

定位：一个按门类成套组织的子Agent合集仓库——核心开发、语言专家、基础设施、AI/ML 等大类，每类下面挂着成排的定义文件，是「awesome 清单」思路在子Agent赛道的落地。

亮点：上手难度全场最低。分类目录本身就是检索界面，想要一个 Python 专家就去语言类里挑，想要一个 Kubernetes 运维就去基础设施类里拿。对想学「子Agent文件该怎么写」的人，它同时是零件库和参考答案集——同一类岗位在不同文件里的写法差异，就是最好的对照教材。

短板：成套供应意味着良莠并存，各文件出自不同贡献者，格式纪律不如 wshobson/agents 那么统一，实战里需要自己筛。它更像图书馆而不是现役部队——收藏价值略高于战斗力。

安装：

git clone https://github.com/VoltAgent/awesome-claude-code-subagents
# 按分类目录挑选需要的 .md，复制进 ~/.claude/agents/

BMAD-METHOD：剧本制，把敏捷团队写成流水线

定位：一句话方法论是「用AI开一支敏捷部队」——分析师、产品经理、架构师、SM、开发、QA 各是一个角色Agent，按两阶段剧本推进：先规划（产出 PRD 和架构文档），再开发（SM 排期、开发写码、QA 验收循环）。

亮点：它是把「协作流程」本身产品化的唯一一个。其他四个件解决「谁去干」，BMAD 解决「按什么顺序干、上一棒给下一棒交接什么」。规划阶段与开发阶段严格分离，开发Agent只吃规划阶段产出的文档，上下文被精心裁剪过——这正是它标榜的「上下文工程」：宁可让Agent看得少，也要让它看得准。对从零开始做的完整项目，这套剧本的完成度明显高于散装派活。

短板：仪式感重。小需求走完整个两阶段流程，成本大于收益；而且它要求用户理解并配合它的阶段切换，对只想「一句话派个活」的用户属于过度设计。

安装（v4 起提供安装器）：

npx bmad-method install

SuperClaude：人格制，一人分饰九角

定位：一个 Python 安装的增强框架，给 Claude Code 加上二十余个斜杠命令和九种人格开关——架构人格、安全人格、前端人格等，一条参数切换「同一个Agent的工作帽」。

亮点：它赌的是另一个方向：不拆Agent，靠人格预设改变同一副脑子的思考侧重。优点是天然没有交接损耗——不存在两个Agent之间传丢上下文的问题，因为从头到尾只有一个人。安装体验也是五个件里最像传统软件的，pip 一路装完。

短板：人格不是真的分工。九顶帽子戴在一颗头上，并行的「量」没有增加，只是「质」的侧重切换；对真正的多线程大活，它给不了蜂群制和兵种库制的吞吐。设计上也因为既要管命令又要管人格，焦点略散。

安装（摘自仓库 README）：

pip install SuperClaude
python -m SuperClaude install

本机在装：协作模式已成底座标配

不只在市场里，协作模式本身也在下沉为装机标配。本环境现装的技能里就能看到三个影子：long-running-agent 管长时任务不中途断线，deep-research 是标准的多路并行扇出再汇总，planning-with-files 用文件当断点续作的交接介质。这三个名字指向同一件事——分包、并行、落盘交接，正在从「第三方框架的卖点」变成「底座出厂能力」。第三方协作件的护城河，正在从「能协作」退到「协作得好」。

深拆：兵种库的一个文件，每一行都在防事故

兵种库制是五个范式里最适合个人上手的一种，值得拆到行。wshobson/agents 里每个兵种都是一个 Markdown 文件，结构高度统一（以下为格式示意，非原文照抄）：

---
name: backend-architect
description: 后端系统架构专家。设计 RESTful API、微服务边界与
  数据模型。涉及 API 设计、服务拆分、数据库选型时主动使用。
tools: Read, Grep, Glob, WebFetch
---

# 角色
你是资深后端架构师……

# 方法论
1. 先问清规模与约束……
2. 给出至少两套方案并对比……

# 输出格式
结论先行，附架构图与权衡表。

第一行 name：短横线小写命名，是派活时的「工号」。命名直接决定主Agent点将时的语义联想——backend-architect 比 agent-01 这种代号强出一个量级。命名要点只有一个：用职能命名，别用编号命名。

第二段 description：整个文件里权重最高的两行。它承担双重职责——既是自我介绍（我是干嘛的），更是派活触发条件（什么情况该叫我）。注意写法结构：「专家身份 + 能力清单 + 使用时机」。最后那句「……时主动使用」是画龙点睛：它告诉主Agent这不是备选项，是匹配到场景就该出手的默认项。兵种库大了以后各兵种会争夺场景归属，description 之间是否「互相让路」，直接决定派活精度——这也是此前生态观察反复验证过的规律：一个字段定生死。

第三段 tools：工具白名单，最小权限原则的落地。架构师只需要读代码和查资料（Read/Grep/Glob/WebFetch），就不给他写文件的权限——架构师的手被绑住，反而保证了他只出图纸不动工。反例是图省事给所有兵种全量工具，后果是「审查员自己顺手把代码改了」，监守自盗。

正文三段式：角色设定（我是谁）→ 方法论（我怎么干活）→ 输出格式（我交什么）。最容易被新手省略的是第三段，但它恰恰是交接协议的关键——子Agent的产出只有「最终报告」能回到主对话，输出格式不预先约定，主Agent收到的就是一篇散文，还得自己再加工一遍。预先约定「结论先行、附权衡表」，回收端就是即插即用的。

通用交接协议：任务书五要素

拆完五个件，把共通纪律提炼成一套可复用的任务书写法。无论你用哪个框架，给子Agent派活时任务书里应该有五样东西：

1. 自包含上下文——子Agent看不见主对话，任务书里必须带全它需要的背景：相关文件路径、已做的决定、约束条件。写「按之前的方案改」等于没写。
2. 产出物契约——要交付什么、什么格式、写到哪个文件。交付物落盘成文件而不是只留在报告里，是跨Agent交接最可靠的介质。
3. 边界声明——只准改哪些目录、不准碰哪些文件、工具只开哪几个。边界越清楚，并发作业越安全。
4. 汇报格式——最终报告的结构约定：做了什么、没做什么、遗留风险。主Agent靠这三段验收。
5. 失败语义——干不动的时候怎么办：是带病交付还是立刻上报。不声明失败语义的兵种，最容易交回一份「看起来完成了」的半成品。

派活全流程

flowchart TD
    A["主Agent接活"] --> B["拆解任务书"]
    B --> C{"选派活范式"}
    C -->|描述匹配| D["兵种库点将"]
    C -->|蜂后调度| E["蜂群动态分配"]
    C -->|阶段剧本| F["角色轮换上岗"]
    D --> G["子Agent执行"]
    E --> G
    F --> G
    G --> H["只回传最终报告"]
    H --> I["产出落盘成文件"]
    I --> J["主Agent合并验收"]
    J --> K{"验收通过？"}
    K -->|否| B
    K -->|是| L["交付"]

这张图里最容易被忽略的是「产出落盘」那一格：派活范式千差万别，但成熟件的收工动作出奇一致——让每个子Agent把成果写进文件，主Agent只读文件合并。对话是易失的，文件才是交接的正仓。

避坑清单

• token 放大：每个子Agent都要重带一份系统提示和任务上下文，五路并行的成本不是五倍是十几倍。小活别分包，一个Agent串行干完更便宜。
• 并发写冲突：多个子Agent同时改同一个文件必出事故。要么按目录划界，要么上 worktree 隔离各干各的分支。
• 库容膨胀：兵种过百后 description 互相踩脚，该出手的没出手。定期裁军，留精兵不留编制。
• 过度分包：拆到第四层子Agent再派孙Agent，上下文损耗会吞掉并行收益。两层为限，超过就该怀疑是在为拆而拆。
• 只看星数装机：协作件的实战表现高度依赖主Agent模型本身的派活能力，同一个件换个底座模型体验可能腰斩。装机前先拿一个真实小项目试跑三天。

推荐排行榜

• 综合首选：wshobson/agents——设计质量与上手成本的黄金交点，个人开发者装它就能起步。
• 功能野心奖：claude-flow——把蜂群编制的天花板立在那里，大项目值得为它付学习成本。
• 教学参考奖：VoltAgent 子Agent合集——想学写子Agent文件，这里是最好的对照教材库。
• 团队流程奖：BMAD-METHOD——从零做一个完整项目，它的两阶段剧本完成度最高。
• 轻量尝鲜奖：SuperClaude——不想改工作目录结构、只想换个帽子试试的用户入口。

参考来源

1. claude-flow — 蜂群制多Agent编排框架，本文安装命令摘自其 README
2. wshobson/agents — 生产级子Agent定义文件合集，本文深拆对象
3. awesome-claude-code-subagents — VoltAgent 维护的按门类分类子Agent合集
4. BMAD-METHOD — 两阶段敏捷AI开发方法论仓库
5. SuperClaude_Framework — 人格切换制增强框架
6. anthropics/skills — 官方 Skills 仓库，子Agent与技能双轨机制的官方参考

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。