# 分包给谁：多Agent协作件横评 ## 概述 本期是工作流自动化系列的收官方向：多Agent协作。此前部署、CI、监控、编排各工位都已逐一盘点过，唯独「一个人干不完、分包给几个Agent一起干」这件事还没系统拆过。本期选了生态里五种有代表性的协作范式——蜂群制（claude-flow）、兵种库制（wshobson/agents）、教材化兵种库（VoltAgent子Agent合集）、剧本制（BMAD-METHOD）、人格切换制（SuperClaude）——横向评测，并把兵种库制的代表拆到子Agent定义文件逐段讲解，最后提炼一套「任务书五要素」交接协议，读者看完可以直接照着给自己的项目写子Agent。 先说核心发现：多Agent协作件的竞争焦点已经从「能派多少个Agent」转移到「交接协议写得有多严」——派活谁都会，收工不失联的没几家。 ## 生态全景 ```mermaid mindmap root((多Agent协作件)) 蜂群制 claude-flow 皇后调度加群体记忆 兵种库制 wshobson agents 一文件一兵种 教材化兵种库 VoltAgent子Agent合集 按门类成套供应 剧本制 BMAD-METHOD 规划与开发两阶段流水线 人格制 SuperClaude 一个Agent分饰九角 ``` 四种范式的分工逻辑完全不同：蜂群制靠一个调度中心动态分配；兵种库制靠描述字段静态匹配；剧本制把协作流程写死成阶段剧本；人格制干脆不拆Agent，让同一个Agent换帽子。下表先给出总评分。 ## 评测对比表 | Skill | 功能完整度 | 设计质量 | 实战效果 | 上手难度 | 社区活跃度 | |-------|-----------|---------|---------|---------|-----------| | claude-flow | ★★★★★ | ★★★★ | ★★★★ | ★★ | ★★★★★ | | wshobson/agents | ★★★★ | ★★★★★ | ★★★★ | ★★★★ | ★★★★★ | | VoltAgent 子Agent合集 | ★★★ | ★★★★ | ★★★ | ★★★★★ | ★★★★ | | BMAD-METHOD | ★★★★ | ★★★★★ | ★★★★ | ★★★ | ★★★★ | | SuperClaude | ★★★★ | ★★★ | ★★★ | ★★★ | ★★★★ | 注：上手难度星级越高表示越容易上手。本表为定性评估，基于各仓库公开文档与社区长期反馈综合判断，未给出具体星数等精确数值。 ## 五个件逐一过堂 ### claude-flow：蜂群制，野心最大的那一台 **定位**：给 Claude Code 装一套完整的蜂群操作系统——一个调度核心（蜂后）把目标拆给一群工蜂Agent并行执行，附带跨会话的群体记忆和上百个配套工具。 **亮点**：它是「编排强度」的上限样本。目标一句话进去，蜂后负责拆解、派发、回收，工蜂各自只看自己的任务书；记忆层让多次会话之间能续上状态，不用每次从零交代。对大规模重构、多模块并行开发这类真·大活，这种建制是单Agent序列作业追不上的。 **短板**：装机成本和心智成本都高。初始化会往项目里铺一层配置，命令面很宽，新手容易「装完不知道第一句说什么」。token 消耗也明显放大——每个工蜂都要带一份自己的上下文，账单是按兵种数量乘上去的。 **安装**（摘自仓库 README）： ```bash npx claude-flow@latest init npx claude-flow@latest swarm "你的目标描述" ``` ### wshobson/agents：兵种库，把派活做成静匹配 **定位**：一套按职业分工预制的子Agent定义文件集合——后端架构师、前端工程师、运维架构师、安全审计员等几十个兵种，一个 .md 文件一个兵，复制进 `~/.claude/agents/` 即可让主Agent按需点将。 **亮点**：设计质量是这一期最高的。它的每个兵种文件都遵守同一套格式纪律：frontmatter 三个字段（名字、描述、工具白名单），正文是一份完整的岗位说明书。主Agent派活不靠额外调度器，靠描述字段自动匹配——你在对话里说「帮我设计一个 API」，后端架构师就自动被请出来。零运行时、零依赖，纯文本协议，可移植性拉满。 **短板**：兵种是静态的，协作也是一次性的——主Agent派一个兵干完收工，兵与兵之间没有横向沟通，复杂项目仍要主Agent自己串场。另外兵种库大了以后，描述字段之间会打架，匹配精度随库容递减。 **安装**： ```bash git clone https://github.com/wshobson/agents cp agents/*.md ~/.claude/agents/ ``` ### VoltAgent 子Agent合集：教材化的成套供应 **定位**：一个按门类成套组织的子Agent合集仓库——核心开发、语言专家、基础设施、AI/ML 等大类，每类下面挂着成排的定义文件，是「awesome 清单」思路在子Agent赛道的落地。 **亮点**：上手难度全场最低。分类目录本身就是检索界面，想要一个 Python 专家就去语言类里挑，想要一个 Kubernetes 运维就去基础设施类里拿。对想学「子Agent文件该怎么写」的人，它同时是零件库和参考答案集——同一类岗位在不同文件里的写法差异，就是最好的对照教材。 **短板**：成套供应意味着良莠并存，各文件出自不同贡献者，格式纪律不如 wshobson/agents 那么统一，实战里需要自己筛。它更像图书馆而不是现役部队——收藏价值略高于战斗力。 **安装**： ```bash 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 起提供安装器）： ```bash npx bmad-method install ``` ### SuperClaude：人格制，一人分饰九角 **定位**：一个 Python 安装的增强框架，给 Claude Code 加上二十余个斜杠命令和九种人格开关——架构人格、安全人格、前端人格等，一条参数切换「同一个Agent的工作帽」。 **亮点**：它赌的是另一个方向：不拆Agent，靠人格预设改变同一副脑子的思考侧重。优点是天然没有交接损耗——不存在两个Agent之间传丢上下文的问题，因为从头到尾只有一个人。安装体验也是五个件里最像传统软件的，pip 一路装完。 **短板**：人格不是真的分工。九顶帽子戴在一颗头上，并行的「量」没有增加，只是「质」的侧重切换；对真正的多线程大活，它给不了蜂群制和兵种库制的吞吐。设计上也因为既要管命令又要管人格，焦点略散。 **安装**（摘自仓库 README）： ```bash pip install SuperClaude python -m SuperClaude install ``` ### 本机在装：协作模式已成底座标配 不只在市场里，协作模式本身也在下沉为装机标配。本环境现装的技能里就能看到三个影子：`long-running-agent` 管长时任务不中途断线，`deep-research` 是标准的多路并行扇出再汇总，`planning-with-files` 用文件当断点续作的交接介质。这三个名字指向同一件事——分包、并行、落盘交接，正在从「第三方框架的卖点」变成「底座出厂能力」。第三方协作件的护城河，正在从「能协作」退到「协作得好」。 ## 深拆：兵种库的一个文件，每一行都在防事故 兵种库制是五个范式里最适合个人上手的一种，值得拆到行。wshobson/agents 里每个兵种都是一个 Markdown 文件，结构高度统一（以下为格式示意，非原文照抄）： ```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. **失败语义**——干不动的时候怎么办：是带病交付还是立刻上报。不声明失败语义的兵种，最容易交回一份「看起来完成了」的半成品。 ## 派活全流程 ```mermaid 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](https://github.com/ruvnet/claude-flow) — 蜂群制多Agent编排框架，本文安装命令摘自其 README 2. [wshobson/agents](https://github.com/wshobson/agents) — 生产级子Agent定义文件合集，本文深拆对象 3. [awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) — VoltAgent 维护的按门类分类子Agent合集 4. [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — 两阶段敏捷AI开发方法论仓库 5. [SuperClaude_Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) — 人格切换制增强框架 6. [anthropics/skills](https://github.com/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 等场景全覆盖。