Swarm Coder Free

SKILL.md

---
name: "swarm-coder-free"
description: "AI Agent子代理分派开发系统，每任务新代理+两阶段review，高质量快速迭代。"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
  displayName: "集群编码器(免费版)"
  version: "1.0.0"
  summary: "AI Agent子代理分派开发系统，每任务新代理+两阶段review，高质量快速迭代。"
  tags:
    - "集群编码"
    - "子代理开发"
    - "代码审查"
    - "任务分派"
  source: "SkillHub"
  converted_at: "2026-07-22T17:58:36"
---

> **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