subagent-driven-development

子 Agent 驱动的开发

每项任务都派遣一名全新的子 Agent，并在每项任务完成后进行两阶段审查。

核心原则： 每项任务使用全新的子 Agent + 两阶段审查（先检查规范，再检查质量）+ 基于差异的验证 = 高质量、快速迭代

快速参考

阶段	角色	操作	退出条件
1	控制器	阅读计划，提取任务，记录 BASE_SHA，创建任务列表	所有任务均已记录 BASE_SHA
2	子 Agent	实施（templates/implementer.md）	已创建提交 + 测试通过 + 报告包含 HEAD_SHA
3	子 Agent	规范审查（templates/spec-reviewer.md）	审查者已检查 diff(BASE..HEAD)，并返回 ✅ 或文件:行号问题
4	子 Agent	质量审查（templates/code-quality-reviewer.md）	审查者已批准差异，或返回标记严重程度的问题
5	控制器	更新状态，标记完成，循环回到第 2 步	所有任务均已完成
6	子 Agent	对整个实现进行最终审查	已批准
7	控制器	使用 finishing-a-development-branch	分支已完成

任务约定

每项任务都必须满足以下约束：

范围：

• 一项任务 = 一个提交（或紧密相关的一组提交）
• 不做顺手重构；不产生纯格式变更
• 不修改无关文件

验证：

• 所有测试均通过（运行完整测试套件或受影响的子集）
• Lint/类型检查通过（如适用）
• 命令必须实际执行（不能假定已执行）

报告必须包含：

• BASE_SHA（由控制器提供）
• HEAD_SHA（提交后）
• 运行的命令（准确且可直接复制粘贴）
• 测试输出摘要（通过/失败 + 数量）
• 更改的文件（列表）
• 范围确认（“无无关更改”）

状态跟踪

控制器维护每项任务的记录：

{
  task_id: string,
  base_sha: string,      # Captured before implementer starts
  head_sha: string,      # From implementer report after commit
  status: pending|in_progress|spec_review|quality_review|complete,
  spec_review_cycles: number,
  quality_review_cycles: number
}

每次阶段转换后更新状态。

流程

设置（仅一次）

1. 只读取一次计划文件
2. 提取所有任务的完整文本和上下文
3. 将当前 HEAD 记录为首项任务的 BASE_SHA
4. 创建包含所有任务的任务列表（状态：待处理）

每项任务的循环

1. 记录此任务的 BASE_SHA（当前 HEAD）
2. 派遣实施者，提供完整任务文本、上下文和 BASE_SHA
3. 如有问题： 充分回答，然后重新派遣并附上答案
4. 实施者完成： 实施、测试、提交，并报告 HEAD_SHA
5. 更新状态： 记录 HEAD_SHA，将状态设为 spec_review
6. 派遣规范审查者，提供任务要求 + diff(BASE_SHA..HEAD_SHA)
7. 如有规范问题： 实施者修复 → 规范审查者重新审查 → 增加循环计数 → 重复，直到 ✅
8. 更新状态： 将状态设为 quality_review
9. 派遣代码质量审查者，提供 BASE_SHA、HEAD_SHA
10. 如有质量问题： 实施者修复 → 质量审查者重新审查 → 增加循环计数 → 重复，直到 ✅
11. 更新状态： 将状态设为 complete，下一项任务的 BASE_SHA = 当前 HEAD_SHA

完成

1. 派遣最终代码审查者，审查整个实现（从首个 BASE_SHA 到最终 HEAD_SHA）
2. 使用 finishing-a-development-branch 技能

提示词模板

• templates/implementer.md — 实施子 Agent
• templates/spec-reviewer.md — 规范符合性验证（基于差异）
• templates/code-quality-reviewer.md — 代码质量评估（基于差异）

完整演练和 SHA 跟踪示例，请参阅 references/example-workflow.md。

危险信号

绝不：

• 跳过审查（规范合规性或代码质量）
• 在问题未修复时继续
• 在同一工作树中派遣并行实现者（会产生冲突）
• 让子代理读取计划文件（应提供完整文本）
• 跳过 BASE_SHA/HEAD_SHA 跟踪
• 让审查者评估“整个仓库”，而不是特定差异
• 接受缺少必需字段（SHA、命令、测试输出）的报告

**并行执行说明：**通过 executing-plans 进行“并行会话”（使用独立分支/工作树）是可行的。禁止“并行实现者”同时修改同一工作树。

**如果子代理提问：**在其继续之前，清楚、完整地作答。

**如果审查者发现问题：**实现者修复 → 审查者重新审查特定差异 → 重复，直到获得批准。

**如果实现者发现需要进行重构：**停止并向控制者报告，请求修订计划。不要强行推进。

依赖项

**需要：**writing-plans（用于创建计划）

**子代理使用：**test-driven-development、requesting-code-review（模板）

**完成后：**finishing-a-development-branch

**替代方案：**executing-plans（适用于并行会话/分支，不适用于并行实现者）

**环境说明：**此技能假设环境中有：git（用于 SHA 跟踪）、任务列表工具（TodoWrite 或等效工具），以及派遣子代理的能力。请根据你的环境调整工具名称。