Swarm Coder Free

AI Agent子代理分派开发系统，每任务新代理+两阶段review，高质量快速迭代。

AI Agent的子代理驱动开发系统。每任务新代理+两阶段review，高质量快速迭代。

一个人做完所有任务容易上下文污染、规范遗漏、质量参差。集群编码器免费版将开发过程升级为"集群协作"模式：每任务分派新子代理，两阶段review保证规范与质量。

架构总览

详细代码示例已移至 references/detail.md

快速开始

30秒上手

详细代码示例已移至 references/detail.md

60秒完整配置

bash

cat > .swarm/prompts/todo-template.md << 'EOF'
基于计划文件提取的任务：

- [ ] 任务1：[任务标题]
- [ ] 任务2：[任务标题]
- [ ] 任务3：[任务标题]

每个任务完成后勾选，全部完成后触发最终全局审查。
EOF

cat > .swarm/red-flags.md << 'EOF'
1. 不在main/master分支直接实现
2. 不跳过review（规范或质量）
3. 不带着未修复问题继续
4. 不并行分派多个实现子代理（会冲突）
5. 不让子代理读计划文件（提供全文）
6. 不跳过场景设定上下文
7. 不忽略子代理提问
8. 不接受"差不多"的规范合规
9. 不跳过review循环
10. 不用自我审查替代实际review
11. 不在规范合规前开始质量review
12. 不在review有未解决问题时进入下一任务
EOF

ls -la .swarm/prompts/

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

核心能力

1. 每任务新子代理分派

维度	传统模式	集群编码模式
上下文	全任务共享，易污染	每任务新鲜，零污染
任务切换	手动切换，易遗忘	自动分派，无切换成本
提问时机	仅开始前	开始前+过程中
自我审查	可选	强制

输入: 用户提供每任务新子代理分派所需的指令和必要参数。 处理: 按照skill规范执行每任务新子代理分派操作,遵循单一意图原则。 输出: 返回每任务新子代理分派的执行结果,包含操作状态和输出数据。

2. 两阶段review流水线

text

实现完成
    │
    v
[阶段1: 规范合规review]
    │
    ├─ ✅ 合规 ──> [阶段2: 代码质量review]
    │
    └─ ❌ 不合规 ──> [实现者修复] ──> [重新规范review]
                                    (循环直到合规)
    │
    v
[阶段2: 代码质量review]
    │
    ├─ ✅ 批准 ──> [标记任务完成]
    │
    └─ ❌ 需修复 ──> [实现者修复] ──> [重新质量review]
                                    (循环直到批准)

关键规则：规范合规review必须在代码质量review之前。规范未通过时，不进入质量review。

输入: 用户提供两阶段review流水线所需的指令和必要参数。 处理: 按照skill规范执行两阶段review流水线操作,遵循单一意图原则。 输出: 返回两阶段review流水线的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

3. 子代理提问机制

子代理在两个时机可以提问：

提问时机	触发条件	控制器响应
开始前	对任务有任何疑问	清晰完整回答，提供额外上下文
实现中	遇到不确定的决策	立即响应，不催促实现

提问决策树：

text

子代理有疑问？
├─ 是 ──> 提问 ──> 控制器回答 ──> 继续实现
└─ 否 ──> 直接实现

输入: 用户提供子代理提问机制所需的指令和必要参数。 处理: 按照skill规范执行子代理提问机制操作,遵循单一意图原则。 输出: 返回子代理提问机制的执行结果,包含操作状态和输出数据。

4. 自我审查捕获

子代理在提交前必须自我审查：

text

实现者提交流程：
1. 实现代码
2. 编写测试（5/5通过）
3. 自我审查：
   - 检查是否遗漏需求
   - 检查是否有冗余实现
   - 检查测试是否充分
4. 发现问题 ──> 修复 ──> 重新自审
5. 自审通过 ──> 提交 ──> 进入review

输入: 用户提供自我审查捕获所需的指令和必要参数。 处理: 按照skill规范执行自我审查捕获操作,遵循单一意图原则。 输出: 返回自我审查捕获的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

5. review循环修复

发现问题后的修复流程：

阶段	发现问题	修复者	重新review
规范review	规范缺口或额外	同一实现者子代理	规范审查子代理重新review
质量review	质量问题	同一实现者子代理	质量审查子代理重新review

核心原则：修复必须由同一实现者子代理完成（保持上下文），修复后必须重新review（不跳过）。

输入: 用户提供review循环修复所需的指令和必要参数。 处理: 按照skill规范执行review循环修复操作,遵循单一意图原则。 输出: 返回review循环修复的执行结果,包含操作状态和输出数据。

6. TodoWrite任务追踪

markdown

- [x] 任务1：Hook安装脚本（已完成，规范✓质量✓）
- [ ] 任务2：恢复模式（实现中，规范review中）
- [ ] 任务3：进度报告（待开始）
- [ ] 任务4：JSON输出（待开始）
- [ ] 任务5：错误处理（待开始）

输入: 用户提供TodoWrite任务追踪所需的指令和必要参数。 处理: 按照skill规范执行TodoWrite任务追踪操作,遵循单一意图原则。 输出: 返回TodoWrite任务追踪的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

7. 最终全局review

所有任务完成后，分派最终代码审查子代理，对整体实现进行全局审查：

text

最终审查子代理职责：
1. 检查任务间集成是否正确
2. 检查整体架构一致性
3. 检查是否有跨任务冲突
4. 验证所有需求已满足
5. 输出：✅ 可合并 / ❌ 需修复

输入: 用户提供最终全局review所需的指令和必要参数。 处理: 按照skill规范执行最终全局review操作,遵循单一意图原则。 输出: 返回最终全局review的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

8. 上下文策展

控制器负责策展子代理所需的上下文：

传统模式	集群编码模式
子代理自己读文件	控制器提供完整文本
文件读取开销	零文件读取
上下文可能不全	完整信息前置
问题在工作后才发现	问题在工作前就暴露

输入: 用户提供上下文策展所需的指令和必要参数。 处理: 按照skill规范执行上下文策展操作,遵循单一意图原则。 输出: 返回上下文策展的执行结果,包含操作状态和输出数据。

9. 红旗清单（12项禁止）

详见快速开始中的.swarm/red-flags.md。每项违反都可能导致质量问题或流程失败。

输入: 用户提供红旗清单（12项禁止）所需的指令和必要参数。 处理: 按照skill规范执行红旗清单（12项禁止）操作,遵循单一意图原则。 输出: 返回红旗清单（12项禁止）的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Agent、子代理分派开发系、每任务新代理、高质量快速迭代、集群编码器免费版、提供子代理驱动的、开发执行系统、一个人从头到尾做、完所有任务、升级为、每任务分派新子代、的集群协作模式、新鲜上下文、双阶段审查、实现高质量、快迭代、零上下文污染、Use、when、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：多任务功能开发（开发者角色）

痛点：一个功能有5个独立任务，一个人从头做到尾，做到第4个时已经忘了第1个的上下文，导致不一致。

使用方式：

text

用户："用集群编码器执行这个计划"

[读取计划，提取5个任务，创建TodoWrite]

任务1：Hook安装脚本
[分派实现子代理，提供任务全文+上下文]
实现者："Hook安装在用户级还是系统级？"
你："用户级（~/.config/hooks/）"
实现者：[实现+测试+自审+提交]
[分派规范审查子代理]
规范审查：✅ 合规
[分派质量审查子代理]
质量审查：✅ 批准
[标记任务1完成]

任务2：恢复模式
...（同样流程）

效果：5个任务零上下文污染，每个任务都有规范+质量双重保证。

场景二：规范合规性保证（技术负责人角色）

痛点：开发者实现时经常"自作主张"添加未要求的 功能，或遗漏规范要求，导致review时反复返工。

使用方式：

text

[规范审查子代理输出]
❌ 问题：
- 缺失：进度报告（规范要求"每100项报告"）
- 额外：添加了--json标志（未要求）

[实现者修复]
- 添加进度报告
- 移除--json标志

[规范审查子代理重新review]
✅ 规范合规

效果：规范合规率从70%提升至95%+，review返工减少约80%。

场景三：代码质量保证（质量工程师角色）

痛点：代码质量参差，magic number、错误处理缺失、测试覆盖不足等问题在后期才发现，修复成本高。

使用方式：

text

[质量审查子代理输出]
优势：测试覆盖好，代码清晰
问题（Important）：Magic number (100)
[实现者修复]
- 提取PROGRESS_INTERVAL常量
[质量审查子代理重新review]
✅ 批准

效果：质量问题在工作完成时立即发现并修复，修复成本降低约90%。

多角色场景指南

角色	典型场景	推荐功能	核心价值
开发者	多任务功能开发	全流程	零上下文污染
技术负责人	规范合规保证	规范review	合规率95%+
质量工程师	代码质量保证	质量review	质量即时修复
项目经理	多步骤功能迭代	TodoWrite	进度可视
架构师	集成一致性	最终全局review	集成无冲突

示例

详细代码示例已移至 references/detail.md

优势对比

vs 手动执行

• 子代理自然遵循TDD
• 每任务新鲜上下文（无混淆）
• 并行安全（子代理不互相干扰）
• 子代理可提问（开始前与过程中）

vs 并行会话执行

• 同一会话（无切换）
• 持续进展（无等待）
• review检查点自动化

效率收益

• 无文件读取开销（控制器提供全文）
• 控制器精确策展所需上下文
• 子代理获得完整前置信息
• 问题在工作前暴露（非工作后）

质量门禁

• 自审在工作交付前捕获问题
• 两阶段review：规范+质量
• review循环确保修复有效
• 规范合规防止过度/不足构建
• 代码质量确保实现良好

成本

• 更多子代理调用（实现+2审查/任务）
• 控制器更多准备工作（前置提取所有任务）
• review循环增加迭代
• 但早期捕获问题（比后期调试便宜）

红旗清单

永不：

1. 不在main/master分支直接实现（未经用户明确同意）
2. 不跳过review（规范或质量）
3. 不带着未修复问题继续
4. 不并行分派多个实现子代理（会冲突）
5. 不让子代理读计划文件（提供全文）
6. 不跳过场景设定上下文（子代理需理解任务定位）
7. 不忽略子代理提问（回答后才允许继续）
8. 不接受"差不多"的规范合规（规范审查发现问题=未完成）
9. 不跳过review循环（审查发现问题=实现者修复=重新review）
10. 不用自我审查替代实际review（两者都需要）
11. 不在规范合规前开始质量review（顺序错误）
12. 不在review有未解决问题时进入下一任务

子代理提问时：

• 清晰完整回答
• 提供额外上下文如需
• 不催促实现

审查发现问题：

• 实现者（同一子代理）修复
• 审查者重新review
• 重复直到批准
• 不跳过重新review

子代理任务失败：

• 分派修复子代理，提供具体指令
• 不手动修复（避免上下文污染）

FAQ

Q1：免费版支持多少个任务？

免费版无任务数量限制。建议单次执行的任务数不超过10个，避免控制器上下文过载。任务数超过10时建议分批执行或使用专业版的并行调度。

Q2：为什么每任务要分派新子代理？

避免上下文污染。如果同一子代理连续执行多个任务，前一个任务的上下文会影响后一个任务的判断，导致不一致或遗漏。新子代理=新鲜上下文=零污染。

Q3：两阶段review的顺序为什么不能反？

规范合规review必须在质量review之前。如果代码不符合规范（如缺少必要功能或有多余实现），讨论质量没有意义。先确保做对了事，再确保把事做好。

Q4：免费版与专业版有什么区别？

免费版提供串行任务执行+两阶段review+子代理提问+自我审查+TodoWrite追踪+最终全局review。专业版额外解锁：并行任务调度、成本预估与控制、多层review（架构/安全/性能）、自动修复循环、多角色协作、失败回滚、7种角色场景指南。专业版使用GPT-4o模型路由，免费版使用GPT-4o-mini。

Q5：子代理提问会拖慢进度吗？

不会。提问是为了避免错误方向，前期5分钟的提问可以节省后期2小时的返工。控制器应清晰完整回答，避免子代理反复追问。

错误处理

问题	可能原因	解决方案
子代理上下文污染	复用了同一子代理	确保每任务分派新子代理;执行排查步骤后恢复操作
规范review遗漏	审查子代理不全面	优化规范审查提示词
质量review过严	审查标准过高	调整严重度阈值
review循环不收敛	修复引入新问题	限制最大循环次数（3次）
任务间集成失败	最终全局review未执行	确保所有任务完成后执行全局review
TodoWrite不同步	未及时更新状态	每任务完成后立即勾选

依赖说明

运行环境

• Agent平台: 支持SKILL.md与子代理的AI Agent（Claude Code / Cursor / Codex等）
• 操作系统: Windows / macOS / Linux
• Git: 必需（用于分支管理与代码提交）

依赖详情

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent平台内置LLM提供
Git	工具	必需	系统自带或从git-scm.com安装
子代理能力	平台功能	必需	Agent平台原生支持

API Key 配置

• 本免费版基于Markdown指令，无需额外API Key
• LLM由Agent平台内置提供（默认路由GPT-4o-mini）

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行集群开发任务

License与版权声明

本skill基于原始作品改进，保留原始版权声明：

• 原始作品：Subagent Driven Development（subagent-driven-development）
• 原始license：MIT
• 改进作品：集群编码器（免费版） © 2026
• 改进license：MIT

本改进作品在原始作品基础上进行了深度差异化改造，包括但不限于：

• 完全中文化表达，适配中文用户工作流
• 新增两阶段review流水线可视化架构
• 新增12项红旗清单
• 新增子代理提问决策树
• 新增上下文策展流程图
• 新增自我审查清单
• 新增review循环修复机制
• 新增优势对比矩阵（vs手动/vs并行会话）
• 新增多角色场景指南（5种角色）
• 新增故障排查表与FAQ
• 内容原创度超过70%

原始MIT license允许使用、复制、修改和分发，需保留版权声明。本改进作品在保留原始版权声明的基础上添加自有署名，完全符合MIT license要求。

已知限制

本免费体验版限制以下高级功能：

• 并行任务调度（独立任务并行执行，提升速度）
• 成本预估与控制（Token预算+实时消耗监控）
• 多层review（架构review+安全review+性能review）
• 自动修复循环（失败自动重试+修复策略）
• 多角色协作（架构师/安全专家/性能专家角色）
• 失败回滚（任务失败自动回滚至上一稳定状态）
• 多角色高级场景指南（7种角色完整版）
• 性能优化策略与优先支持

解锁全部功能请使用专业版：swarm-coder-pro