# 拆superpowers：Agent怎么带Agent ## 概述 本期是工作流自动化赛道的定期观察。部署四件（官方那套胖瘦差百倍的）和CI值守六件在前面几轮已经评过，这轮只看剩下的空白位置：**多Agent协作**——主Agent怎么派活、怎么验收、怎么防止一群子Agent把上下文搅成一锅粥。本期横评四件：流程派的`obra/superpowers`（深拆其编排Skill）、名片派的`VoltAgent/awesome-claude-code-subagents`、部门派的`wshobson/agents`、框架派的`ruvnet/claude-flow`。核心发现一句话：**这个赛道赢的不是谁Agent多，而是谁把「指挥手册」写得最不留歧义**。需要说明：本期受抓取环境所限未逐一核对精确星标数，上榜判断基于各仓库近一年的公开更新与社区讨论热度，文中不编精确数字。 ## 先看底盘：原生subagent机制给了什么 评之前必须交代底盘，否则分不清哪些是原生能力、哪些是Skill的功劳。Claude Code在2025年中把subagent做成了原生特性：项目里放`.claude/agents/*.md`，每个文件用YAML frontmatter声明名字、职责描述和可用工具，主Agent通过Agent工具把任务派给这些子Agent，子Agent有独立上下文窗口，干完只把结论交回来。 底盘给的是「兵」：可以派、可以并行、上下文隔离。但它没给「指挥学」——什么时候该派、派几个、任务怎么写才不跑偏、验收标准是什么、失败了怎么回炉。原生机制对这些问题一概不管，全靠主Agent自由发挥。这就是本期四件商品要填的空：**它们卖的都是指挥学**。 ## 评测对比表 | Skill | 定位 | 功能完整度(25%) | 设计质量(25%) | 实战效果(20%) | 上手难度(15%) | 社区活跃度(15%) | 加权总分 | |---|---|---|---|---|---|---|---| | obra/superpowers | 流程SOP库 | ★★★★½ | ★★★★★ | ★★★★½ | ★★★★ | ★★★★★ | **4.6** | | VoltAgent/awesome-claude-code-subagents | 百人工牌库 | ★★★★ | ★★★½ | ★★★½ | ★★★★½ | ★★★★½ | **3.9** | | wshobson/agents | 部门名册库 | ★★★½ | ★★★½ | ★★★½ | ★★★★ | ★★★★ | **3.7** | | ruvnet/claude-flow | swarm编排框架 | ★★★★½ | ★★★½ | ★★★½ | ★★½ | ★★★★ | **3.7** | ## 主角深拆：superpowers的subagent-driven-development ### 它是什么 `obra/superpowers`出自Jesse Vincent（GitHub ID: obra，Perl社区RT系统的作者）之手，2025年秋发布后迅速出圈，是流程派Skill的代表作。整个仓库以plugin形式安装，内含一二十个互相引用的流程Skill：先聊清楚再动手的brainstorming、写技术方案的writing-plans、按计划执行的executing-plans、TDD流程、系统化调试、git worktree隔离，以及本期要拆的编排核心——**subagent-driven-development**。 它回答的问题很具体：当你有一份写好的任务计划，主Agent是自己撸袖子干，还是带一支临时工队伍干？superpowers给出的答案激进得多——**主Agent不许自己写代码，一行都不行**。 ### 逐段拆：这份指挥手册怎么写的 **第一段：角色锁死。** SKILL.md开篇就把主Agent的身份钉死成「编排者」：你的工作是分派、追踪、验收，明确禁止亲自实现任何功能。这不是修辞性开场，是行为约束——模型拿到长任务时天然倾向于自己上手，因为那样「感觉更快」，而这恰恰是上下文爆炸的起点。开篇一句角色声明，把整条歧义路径堵死。这是全文最值得抄的一句话设计。 **第二段：任务派发模板。** 手册要求主Agent每派一个实现子Agent，必须带上完整包裹：任务全文、所属计划的上下文、涉及文件路径、验收标准。不许说「你看着办」，也不许指望子Agent自己去翻之前的对话——因为子Agent是一次性的、没有历史记忆，它的一切认知都必须装进派发包裹里。这一段本质上是把「交接文档怎么写」工程化了，跟人类团队里高级工程师写issue的纪律一模一样。 **第三段：双评审串行过闸。** 实现子Agent交活后，手册要求**两个**独立的评审子Agent依次过审：第一个只对规格，拿任务描述逐条核对做没做全；第二个只对代码质量，看实现方式、可维护性、有没有埋雷。两个评审员互不通气，各自只对主Agent汇报结论。拆到这里能看到设计者的两处心机： - 评审员与实现者**上下文隔离**——评审员没看过实现过程，只看成品，天然避免了「自己人护短」； - 评审是**串行双闸**而不是单闸——规格评审先过，质量评审才开工，防止在错误的方向上讨论优美的代码。 **第四段：修复回路。** 任一评审员给出不通过，主Agent就派新的子Agent去修，修完重走两道闸，直到双通过才把该任务标记完成。手册刻意要求「派新Agent去修」而不是「让原实现者自己修」——听起来浪费，实际上是用一次性上下文换干净度：修bug的Agent只带着「问题清单+相关代码」进场，不会被上一个实现者的错误思路污染。 **第五段：串行纪律。** 整个流程同时只开一个子Agent，做完一个再派下一个。很多人第一反应是「这也太慢了，不能并行吗」，但这正是流程派对多Agent协作最重要的判断：**并行协作的第一杀手不是速度，是串话**——两个子Agent同时改一个文件、互相覆盖、主Agent对不上账。superpowers选择先把串行流程跑对，并行交给另一件Skill（配合worktree隔离）专门处理。这个「先对账、再提速」的取舍，比功能清单值钱。 ### 全流程一图 ```mermaid flowchart TD A["主Agent读计划"] --> B["取出下一任务"] B --> C["打包上下文派发"] C --> D["实现子Agent写码"] D --> E["规格评审员过闸"] E --> F["质量评审员过闸"] F --> G{"双审通过？"} G -->|否| H["派新Agent修复"] H --> E G -->|是| I["标记完成"] I --> J{"还有任务？"} J -->|有| B J -->|无| K["交付汇总"] ``` 11个节点就把整条流水线画完了。对比人类工程组织的译法：主Agent是tech lead，实现子Agent是外包工程师，两个评审员是测试和架构师，且这套流程里**没有任何一个角色需要记住整个项目的历史**——所有认知都随派发包裹流转。这就是它能在大仓库里稳住的根本原因。 ### 短板 流程重、token开销大——一个中等任务走完「实现+双评审+可能修复」要多花数倍于单Agent的成本；小改动用它属于杀鸡用牛刀。另外它的Skill之间互相引用形成网，想单拆一件来用会发现缺前置，基本得整套安装。 ## 其余三件速评 ### VoltAgent/awesome-claude-code-subagents：名片派 VoltAgent（一个TypeScript agent框架团队）维护的精选集，收录上百个子Agent定义文件，按core开发、语言专家、基础设施、AI自动化、市场商务等目录归档，每个文件就是标准的`.claude/agents`格式：YAML头写清name、description、tools、model，正文是成型的系统提示词。它的价值在「直接发工牌」——你想要一个GraphQL专家或支付集成专家，抄一个文件进`.claude/agents/`目录就能用。短板也明显：**它只发工牌、不发调度手册**，一堆专家躺在目录里，谁先谁后、怎么验收全不管，协作全靠主Agent自觉。设计质量被superpowers拉开一档的根源就在这：它是素材库，不是指挥学。适合已经想清楚自己流程、只缺角色模板的成熟用户。 ### wshobson/agents：部门派 个人维护者的名册仓库，八十多个子Agent按业务域分部门：云原生、DevOps、数据、安全、商务各一排，粒度比VoltAgent更细，一个领域里按 junior/senior 级别和细分方向再分档。配套的commands仓库提供斜杠命令把这些角色串成调用链。优点是检索快、角色画像写得克制，描述里塞了足够的关键词让主Agent能自动选对人。短板：部门虽全，**部门之间的协作协议还是空白**，跨部门任务（比如「改API顺便更新文档」要动两个部门的人）依然靠主Agent现编流程。此外个人仓库的更新节奏依赖单人精力，长期活跃度要打问号。 ### ruvnet/claude-flow：框架派 四件里唯一的重家伙。claude-flow不是Skill而是完整编排框架：swarm和hive-mind两种多Agent模式、SQLite持久化记忆、MCP服务器、自带CLI（`npx claude-flow@alpha`起步），宣称支持几十种编排模式和 swarm 拓扑。它的野心是把多Agent协作做成基础设施——你可以定义一队Agent按拓扑并行攻一个目标，中间状态落库可恢复。功能维度给分最高，但代价在表上也看得见：**上手难度全场最低分**。概念多（swarm/hive-mind/memory/MCP叠在一起）、文档被营销式口号稀释、排错成本高，第一次跑通的概率明显低于前三件。而且它本质是「外挂指挥系统」，与Claude Code原生机制的关系需要用户自己理顺。适合真要跑长周期、多阶段大项目的重度玩家，不适合当第一件协作工具装。 ## 安装命令 ```bash # superpowers（流程派，plugin方式，据其README） /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace # awesome-claude-code-subagents（名片派，挑文件拷入项目） git clone https://github.com/VoltAgent/awesome-claude-code-subagents cp awesome-claude-code-subagents/categories/*/你选的角色.md .claude/agents/ # wshobson/agents（部门派，同样拷文件制） git clone https://github.com/wshobson/agents cp agents/你选的角色.md .claude/agents/ # claude-flow（框架派，CLI初始化） npx claude-flow@alpha init ``` ## 赛道分类图 ```mermaid mindmap root((多Agent协作)) 流程派 superpowers 指挥手册写进SKILL 名片派 awesome-subagents 百张工牌随取 部门派 wshobson agents 按领域分档案 框架派 claude-flow 外挂编排底座 ``` ## 推荐排行榜 - **总分榜**：superpowers 4.6 ＞ awesome-claude-code-subagents 3.9 ＞ wshobson/agents ≈ claude-flow 3.7 - **设计最佳**：superpowers——双评审串行闸和「主Agent禁止动手」两条约束，是本赛道目前最成熟的提示词工程样本 - **上手最快**：awesome-claude-code-subagents——拷一个文件五分钟见效，零概念负担 - **预算之选**：wshobson/agents——免费工牌库里的性价比款，适合按需零拷 - **避坑提示**：claude-flow功能最重但请留到第三个项目再装；另外别把本期任何一件和前几轮评过的CI值守件混装——指挥层和值守层抢同一个主Agent的注意力时会互相打架，先跑通一层再说 ## 选型结论 多Agent协作这个类目，2025年靠「Agent数量」讲故事，2026年拼的已经是「指挥手册的密度」。四件横评下来规律很清楚：名片派和部门派供给的是**角色**，框架派供给的是**底座**，而评分断层领先的superpowers供给的是**流程**——它把「什么时候派、派谁、带什么上下文、谁来验收、不过怎么办」写成了不容歧义的SKILL.md文本，这才是这一轮多Agent协作竞争里真正的护城河。想自己写协作类Skill的读者，直接把subagent-driven-development当模板抄结构：角色锁死、派发模板、双闸验收、修复回路、串行纪律，五段齐了，你的第一份指挥手册就能用了。 ## 参考来源 1. [obra/superpowers](https://github.com/obra/superpowers) — 流程派Skill库，本期深拆对象，含subagent-driven-development等编排Skill 2. [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) — 百余个子Agent定义精选集，名片派代表 3. [wshobson/agents](https://github.com/wshobson/agents) — 按领域分部门的子Agent名册仓库 4. [ruvnet/claude-flow](https://github.com/ruvnet/claude-flow) — swarm编排框架，多Agent协作底座 5. [anthropics/skills](https://github.com/anthropics/skills) — Anthropic官方Skills仓库，原生subagent机制的文档参照 > [!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 等场景全覆盖。