术语说明Swarm/蜂群是多Agent协作的通用说法OpenAI有官方项目叫Swarm但 Claude Code的官方概念是Agent Teams。本文使用官方术语Agent Teams保留蜂群作为通俗说明。先说老金我昨儿开源了老金开源10万字Claude Code中文教程零基础到企业实战完整路径希望大家可以看看顺手帮我点个Star这样能让更多的人来接触到AI做出自己喜欢的东西。上周老金我写了那篇CC本次更新最强的不是OPUS4.6而是Agent Swarm(蜂群群里收到最多的一个问题是“老金每次都要手动写那么长的提示词有没有更简单的方法” “有。”老金我花了一周时间把这套多Agent编排逻辑封装成了一个Claude Code Skill。说句拉个团队就能自动组队、自动分工、自动验收。今天把它开源了。在做本Skill的时候老金真实的感触真的是很难想象。仅仅只有216行提示词已经完成了我以前庞大的轮子制造这再也不是一个造轮子的时代了真的飞速发展但也要请你清楚这篇文章内的都是精华中的精华所以它很长。如果你不清楚这些你拿多少提示词也不好使。认知才是能用好AI的前提。不是许愿。先说结论这个Skill叫 agent-teams-playbook解决的核心问题是让Claude Code从你指挥它干活变成它自己当CTO组队干活。你只需要描述任务它会自动完成这些事1、判断任务复杂度选择最合适的编排场景2、组建团队给每个Agent分配角色和模型3、并行执行实时汇报进度4、质量把关产品打磨不只是能跑还要好用5、交付结果部署说明做完了告诉你怎么用全程你只需要在关键节点点头确认。术语也顺便说清楚swarm/蜂群是通用说法OpenAI甚至有官方项目就叫Swarm。但 Claude Code的官方概念叫Agent Teams。teammate是独立Claude Code实例各自有上下文窗口、能互相沟通、你也能直接切过去聊。所以这个Skill的正确定位是并行外脑 汇总压缩的编排器不是单脑扩容器。理解这一点才能用对它、用好它。为什么要做这个Skill上篇文章老金我给了6种玩法的提示词模板实际用下来发现几个问题问题1每次都要手动判断该用哪种玩法任务来了你得先想这个任务是简单还是复杂需要几个Agent用Subagent还是Agent Team每次都要做一遍决策累。问题2提示词太长复制粘贴改来改去上篇文章的提示词模板最长的有200多字。每次用都要复制、修改角色名、调整任务描述效率不高。问题3没有质量把关Agent干完就完了好不好全靠运气。没有统一的验收标准没有打回修改的机制。问题4没有统一的流程每次都是临时拼凑这次用这个流程下次用那个流程。没有沉淀没有复用。老金我就想能不能把这些判断逻辑、流程规范质量标准全部封装起来让Claude Code自己判断、自己组队、自己把关于是就有了 agent-teams-playbook。核心设计给AI装个技术合伙人的脑子这个Skill的第一行定义就不一样你是Technical Co-Founder级别的Agent Teams协调器——不只是分配任务而是明确每个角色的职责边界、把控执行过程、对最终产品质量负责。Technical Co-Founder直译是技术联合创始人。说人话就是创业公司里那个懂技术的合伙人既能写代码又能带团队的CTO角色。为什么要给AI定这个角色因为普通的任务协调器只会机械地分配任务而一个好的技术合伙人会做这5件事1、质疑需求需求不合理时主动挑战假设建议更好的方案2、界定范围区分现在必须做和以后再说砍掉非核心范围3、选择策略根据任务复杂度选择最合适的编排方式4、把控质量不只是能用还要好用——边界处理专业度、完整性5、交付移交做完了告诉你怎么用、怎么验证、有什么限制这就是从工具人到合伙人的区别。5大编排场景自动选择不用你操心Skill内置了一棵决策树根据任务复杂度自动选择场景Q1: 任务复杂度 ├── 简单(1-2步) → 场景1提示增强 ├── 中等(3-5步) → Q2: 有现成Skill可复用 │ ├── 是 → 场景2Skill复用 │ └── 否 → 场景3计划评审默认 └── 复杂(6步) → Q3: 需要明确团队分工 ├── 是 → 场景4Lead-Member └── 否 → 场景5复合编排每个场景干什么1、 提示增强 任务太简单不需要组队。举个例子“帮我改个函数名”2、 Skill复用 有现成Skill能用直接调。举个例子“帮我写篇公众号” → 调gzh-writer3、 计划评审 出计划→你确认→并行执行→Review。举个例子“重构认证模块”最常用4、 Lead-Member Leader协调Member并行干活。举个例子“做一个完整的用户系统”5、 复合编排 动态组合上面的场景。举个例子“从0搭建一个SaaS产品”重点你不需要记这些。说拉团队帮我重构认证模块Skill会自动判断这是场景3然后按流程走。你也可以直接指定“用场景4帮我做用户系统”跳过决策树直接执行。5阶段工作流终端里实际会输出什么这是老金我最想展示部分——以下是基于Skill规范编排的 演示示例展示理想情况下的执行流程。实际输出格式会因任务类型和模型响应而略有差异。用一个真实场景演示“拉团队帮我重构认证模块”。阶段1任务分析Discovery我让他帮我充够KIMI生成的个人主页。Claude Code输出我还设计了——必须你确认才会继续。这不是走过场是真的等你点头。如果你觉得范围不对可以直接说OAuth也要做它会重新调整计划。PS当然你觉得麻烦也可以直接说 不需要问我你自己全决定不过老金我很不建议这么做因为它不懂你的细节需求很容易跑偏。阶段2团队组建你输入继续后注意模型分工根据不同的任务它会选用不同的模型。这不是随便选的是根据任务复杂度自动分配的。这里动手能力强的可以把其他模型以MCP或Agent方式接入。可以参考老金的开源项目来参考对比明明白白3大顶级模型-GPT-5.2/Gemini 3/Claude Opus 4.5老金告诉你怎么一个窗口全用为了大家方便这里统一用Cluade旗下的haiku处理简单任务比如格式化、文件搜索sonnet处理常规编码opus处理需要深度思考的架构设计。同样的活用对模型能省不少钱。阶段3并行执行4个Agent同时启动各干各的如果某个Agent失败了小问题自行修复大问题想你给你选项你自己说解决方案阶段4质量把关 产品打磨这个阶段是Skill的核心——不只是检查能不能跑还要检查好不好用最多打回2轮2轮还不行就通知你人工介入。产品打磨三个维度边界处理异常情况覆盖了没专业度命名规范、错误提示友好不完整性文档、配置、示例齐全不阶段5结果交付 部署移交从任务分析到部署移交全流程自动化。你只在阶段1确认了一次计划剩下的全是Skill在驱动。后续建议那栏特别有用——它会把阶段1砍掉的add-later内容列出来提醒你下一步可以做什么。如果对你有帮助记得关注一波~两种协作模式按需选择Subagent模式通信方式单向汇报Agent→协调器适用场景任务间没有依赖启动方式Task工具Agent Team模式通信方式双向通信Agent↔Agent适用场景任务间需要互相协调启动方式TeamCreate SendMessage老金的建议90%的场景用Subagent就够了。Agent Team功能更强但成本更高每条消息都消耗token只有任务间真的需要互相沟通时才用。安装前提先装这两个Skill这个Skill依赖两个前置Skill才能发挥完整功能建议先安装PS请手动安装老金我没放Skill里否则每次都浪费token必装1find-skills自动发现社区Skill它是Claude Code生态里的Skill发现工具能从社区索引中搜索数百个开源Skill。比如你说帮我做个数据可视化find-skills会自动搜索有没有专门做数据可视化的Skill可以用。这里直接安装老金改良过的的兼容Win版本。npx skills add KimYx0207/findskillfind-skills -y或者手动安装仓库地址https://github.com/KimYx0207/findskill把SKILL.md放到 .claude/skills/find-skills/ 目录编排器怎么用它在阶段2组建团队时协调器会先问find-skills“当前任务有没有专门的Skill可以用”如果有就给对应的Agent指定这个Skill如果没有就用通用agent。老金之前写过一篇find-skills的详细教程24小时15.3K安装量稳坐王座老金愿称之为元Skill必装2planning-with-files自动生成计划文件npx skills add anthropic-ai/planning-with-files -y或者手动安装仓库地址https://github.com/anthropic-ai/claude-code-skills把planning-with-files的SKILL.md放到 .claude/skills/planning-with-files/ 目录作用自动生成task_plan.md、findings.md、progress.md让任务进度可追踪。不装也能用如果暂时不想装上面两个agent-teams-playbook也能用find-skills不可用 → 自动用本地Skill → 再不可用就用通用Agentplanning-with-files不可用 → 跳过自动生成文件这一步不会报错只是功能会降级。安装使用3步搞定第1步创建目录mkdir -p .claude/skills/agent-teams-playbook第2步放入SKILL.md把完整的SKILL.md文件放到这个目录下。216行直接复制粘贴就能用。完整代码见GitHub仓库文末有地址。第3步触发使用以下任何一种方式都能触发# 自然语言触发随便说 拉团队帮我重构认证模块 帮我组个Agent团队做代码审查 用多Agent并行处理这个任务 agent swarm帮我搞定这个需求 # 直接指定场景 用场景4帮我做用户系统不需要安装其他依赖不需要配置环境变量不需要启动服务。放进去就能用。进阶玩法和生态工具组合这个Skill不是孤立存在的你可以 手动组合 其他工具来增强功能。Claude Code的Skill生态正在快速成长老金我逐个讲清楚可以怎么组合。find-skillsSkill自动发现机制agent-teams-playbook内置了一个 Skill回退链 检测find-skills是否可用 ↓ 可用 搜索匹配当前任务的Skill ↓ 找到 调用匹配的Skill执行 ↓ 没找到或不可用 回退到本地已安装的Skill ↓ 本地也没有 使用通用流程general-purpose agentSuperpowers14个开发工作流SkillGitHub地址 https://github.com/obra/superpowers这是 Jesse Vincentobra做的一套完整的Claude Code开发工作流Skill集合包含14个独立Skill覆盖从头脑风暴到代码合并的完整生命周期。你可以参考以下对应关系来组合使用brainstorming → 需求澄清、方案设计 → 建议用于阶段1writing-plans → 拆解任务、写实施计划 → 建议用于阶段2dispatching-parallel-agents → 并行派发Agent → 建议用于阶段3subagent-driven-development → 子Agent驱动开发两阶段Review → 建议用于阶段34test-driven-development → RED-GREEN-REFACTOR → 建议用于阶段3实现者用requesting-code-review → 代码审查 → 建议用于阶段4finishing-a-development-branch → 合并/PR/清理 → 建议用于阶段5关键区别superpowers是一个 工具库14把独立的工具agent-teams-playbook是一个 编排器决定什么时候用哪把工具、怎么组合。打个比方superpowers 工具箱里的锤子、螺丝刀、扳手每个工具干一件事agent-teams-playbook 项目经理看了图纸后决定先用扳手再用锤子它们是互补的不是竞争的。组合使用时在阶段2给不同角色的Agent指定superpowers的Skill团队蓝图示例 架构师 brainstorming writing-plans 实现者 subagent-driven-development TDD 审查员 requesting-code-review 收尾员 finishing-a-development-branch编排器负责编排谁先谁后、并行还是串行superpowers的Skill负责每个角色的具体执行。老金之前写过一篇superpowers的详细教程Claude Code 30k star官方插件小白也能写专业级代码planning-with-files计划落地成文件这俩是 可以互补 的——编排器负责编排决策planning-with-files负责把计划写成可追踪的文件。阶段对应关系阶段1任务分析编排器负责决策场景、选协作模式planning-with-files负责生成 task_plan.md阶段2团队组建编排器负责分配角色、选模型planning-with-files负责生成 findings.md阶段3并行执行编排器负责协调多Agent并行planning-with-files负责各Agent更新 progress.md阶段4-5质量把关交付编排器负责质量把关交付planning-with-files负责最终状态写入文件建议的操作流程用户帮我重构认证模块拉团队搞 → 编排器启动 → 阶段1调 /planning-with-files 生成 task_plan.md findings.md → 阶段2基于 task_plan.md 组建团队 → 阶段3各Agent执行进度写入 progress.md → 阶段4质量把关结果写入 findings.md → 阶段5交付报告最终状态更新到 task_plan.md效果计划有文件执行有团队进度可追踪。你随时打开 progress.md 就能看到每个Agent干到哪了。老金之前写过一篇planning-with-files的详细教程Claude Code神器Manus同款文件规划法价值20亿美元的工作流秘密TDD工作流代码有测试保障在阶段2组建团队时你可以给实现者Agent指定TDD专用的subagent_type让每个实现者自动遵循测试驱动开发。组合场景团队里有实现者角色给实现者指定 subagent_type: “everything-claude-code:tdd-guide”需要写新功能实现者按TDD流程写测试(RED) → 实现(GREEN) → 重构(IMPROVE)质量把关阶段自动检查测试覆盖率是否≥80%建议的团队蓝图1、架构师 设计接口和模块划分 模型opus subagent_typeExplore2、实现者A TDD实现认证模块 模型sonnet subagent_typeeverything-claude-code:tdd-guide3、实现者B TDD实现权限模块 模型sonnet subagent_typeeverything-claude-code:tdd-guide4、审查员 Code Review 模型sonnet subagent_typeeverything-claude-code:code-reviewer注意看subagent_type那列——实现者用 tdd-guide自动走TDD流程审查员用 code-reviewer自动做代码审查。不是你手动告诉它请用TDD而是Agent类型本身就决定了工作方式。老金之前写过一篇everything-claude-code的详细教程黑客松冠军配置老金拆解8大核心思路值得反复品味终极组合五件套把上面所有工具串起来 注意这需要用户手动安装各个Skill先 find-skills → 自动发现可用的社区Skill ↓ planning-with-files → 生成结构化计划文件 ↓ agent-teams-playbook → 基于计划文件组队编排 ↓ superpowers skills → 每个Agent用专业Skill执行 ↓ tdd-guide → 实现者遵循TDD流程Skill自动发现、计划有文件、编排有策略、执行有专业Skill、代码有测试。老金我的建议是你可以按需组合这些工具。agent-teams-playbook作为编排器负责决策什么时候用哪个工具、怎么组合。其他工具作为专业Agent或Skill被编排器调用。这套组合的理想效果是你说一句帮我做个用户系统Claude Code会1、find-skills搜索有没有专门做用户系统的Skill2、planning-with-files生成计划文件3、编排器判断场景、组建团队4、架构师用brainstorming设计方案5、实现者用TDD写代码6、审查员做Code Review7、收尾员处理合并和部署你只需要在关键节点点头确认。设计原则老金踩过的坑做这个Skill的过程中老金我踩了不少坑总结了7条底线写进了代码里1、 先目标后组织结构 ——任务不清晰时先澄清不急着组队2、 队伍不超过5个 ——Agent多了反而乱沟通成本指数级增长3、 关键节点必须有质量闸门 ——不能Agent干完就算完4、 不默认任何工具可用 ——find-skills不一定装了执行前先验证5、 成本只是约束不是承诺 ——不做省50%成本这种不切实际的预估6、 遇到问题给选项 ——不替用户做决定让用户选7、 危险操作必须确认 ——大规模变更、删除操作必须用户点头这7条是从实际使用中总结出来的每一条背后都有一个翻车故事。开源地址仓库地址https://github.com/KimYx0207/agent-teams-playbookSkill完整代码只有216行放进 .claude/skills/agent-teams-playbook/SKILL.md 就能用。不需要任何依赖不需要任何配置。装了它编排器的Skill回退链就能自动发现社区Skill。老金往期教程导航这套Agent Teams生态老金我之前每个工具都写过详细教程按照从框架到成员的顺序排好了1、 Agent Teams多Agent协作 框架主力军教程地址https://my.feishu.cn/wiki/CAsLwb5BBiVztakm0h9cGnucnRc2、 everything-claude-code 专业Agent类型库教程地址https://my.feishu.cn/wiki/Jqf3wAPh2ixRifkssykcnNJOnkg3、 find-skills 最关键的成员教程地址https://my.feishu.cn/wiki/HVU6wTCRoiThWAkgyLac7w3Yncb4、 planning-with-files 计划落地文件教程地址https://my.feishu.cn/wiki/QG5Aw1fpZikJP5kHyhrcwRlznMc5、 superpowers 14个执行Skill教程地址https://my.feishu.cn/wiki/Y2gqwjSQbiygUgkNuvMcEU4nnLd建议阅读顺序先看1了解框架全貌 → 再看3掌握Skill发现机制 → 然后2、4、5按需深入。评论区聊聊老金我每条都看。觉得有用的话转发给你身边用Claude Code的朋友别让他们还在手动拼提示词。往期推荐AI编程教程列表提示词工工程Prompt EngineeringLLMOPS(大语言模运维平台)AI绘画教程列表WX机器人教程列表每次我都想提醒一下这不是凡尔赛是希望有想法的人勇敢冲。我不会代码我英语也不好但是我做出来了很多东西在文末的开源知识库可见。我真心希望能影响更多的人来尝试新的技巧迎接新的时代。谢谢你读我的文章。如果觉得不错随手点个赞、在看、转发三连吧如果想第一时间收到推送也可以给我个星标⭐谢谢你看我的文章。开源知识库地址https://tffyvtlai4.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf