subagent-driven-development

子 Agent 驱动开发

通过为每项任务分派一个全新的子 Agent 来执行计划，并在每项任务后进行代码审查。

核心原则： 每项任务都使用全新的子 Agent + 任务之间进行审查 = 高质量、快速迭代

概述

与执行计划（并行会话）相比：

• 同一会话（无需切换上下文）
• 每项任务都使用全新的子 Agent（避免上下文污染）
• 每项任务后进行代码审查（及早发现问题）
• 迭代更快（任务之间无需人工介入）

适用场景：

• 在当前会话中继续工作
• 任务大多相互独立
• 希望持续推进，同时设置质量关卡

不适用场景：

• 需要先审查计划（使用 executing-plans）
• 任务紧密耦合（手动执行更好）
• 计划需要修改（先进行头脑风暴）

流程

1. 加载计划

读取计划文件，并使用 TodoWrite 创建包含所有任务的待办列表。

2. 使用子 Agent 执行任务

针对每项任务：

分派全新的子 Agent：

Task tool (general-purpose):
  description: "Implement Task N: [task name]"
  prompt: |
    You are implementing Task N from [plan-file].

    Read that task carefully. Your job is to:
    1. Implement exactly what the task specifies
    2. Write tests (following TDD if task says to)
    3. Verify implementation works
    4. Commit your work
    5. Report back

    Work from: [directory]

    Report: What you implemented, what you tested, test results, files changed, any issues

子 Agent 返回工作摘要。

3. 审查子 Agent 的工作

分派代码审查员子 Agent：

Task tool (code-reviewer):
  Use template at requesting-code-review/code-reviewer.md

  WHAT_WAS_IMPLEMENTED: [from subagent's report]
  PLAN_OR_REQUIREMENTS: Task N from [plan-file]
  BASE_SHA: [commit before task]
  HEAD_SHA: [current commit]
  DESCRIPTION: [task summary]

代码审查员返回： 优势、问题（严重/重要/轻微）、评估

4. 处理审查反馈

如果发现问题：

• 立即修复严重问题
• 在开始下一项任务前修复重要问题
• 记录轻微问题

必要时分派后续子 Agent：

"Fix issues from code review: [list issues]"

5. 标记完成并开始下一项任务

• 在 TodoWrite 中将任务标记为已完成
• 转到下一项任务
• 重复步骤 2-5

6. 最终审查

完成所有任务后，分派最终代码审查员：

• 审查整个实现
• 检查是否满足计划中的所有要求
• 验证整体架构

7. 完成开发

最终审查通过后：

• 宣布：“我将使用 finishing-a-development-branch 技能来完成这项工作。”
• 必需子技能： 使用 finishing-a-development-branch
• 按照该技能验证测试、列出选项并执行所选方案

工作流示例

You: I'm using Subagent-Driven Development to execute this plan.

[Load plan, create TodoWrite]

Task 1: Hook installation script

[Dispatch implementation subagent]
Subagent: Implemented install-hook with tests, 5/5 passing

[Get git SHAs, dispatch code-reviewer]
Reviewer: Strengths: Good test coverage. Issues: None. Ready.

[Mark Task 1 complete]

Task 2: Recovery modes

[Dispatch implementation subagent]
Subagent: Added verify/repair, 8/8 tests passing

[Dispatch code-reviewer]
Reviewer: Strengths: Solid. Issues (Important): Missing progress reporting

[Dispatch fix subagent]
Fix subagent: Added progress every 100 conversations

[Verify fix, mark Task 2 complete]

...

[After all tasks]
[Dispatch final code-reviewer]
Final reviewer: All requirements met, ready to merge

Done!

优势

与手动执行相比：

• 子 Agent 会自然地遵循 TDD
• 每项任务使用全新的上下文（避免混淆）
• 支持安全并行（子 Agent 之间不会互相干扰）

与执行计划相比：

• 同一会话（无需交接）
• 持续推进（无需等待）
• 自动设置审查检查点

成本：

• 调用子 Agent 的次数更多
• 但能及早发现问题（比之后调试成本更低）

危险信号

切勿：

• 跳过任务之间的代码审查
• 带着未修复的严重问题继续推进
• 并行分派多个实现子 Agent（会产生冲突）
• 未阅读计划任务就开始实现

如果子 Agent 未能完成任务：

• 提供具体指示，分派修复子 Agent
• 不要尝试手动修复（会造成上下文污染）

集成

必需的工作流技能：

• writing-plans - 必需：创建此技能要执行的计划
• requesting-code-review - 必需：每项任务后进行审查（参见步骤 3）
• finishing-a-development-branch - 必需：所有任务完成后结束开发（参见步骤 7）

子 Agent 必须遵循：

• 测试优先规范 - 每个子 Agent 都要先为自己的任务编写一个失败测试，再进行实现，随后让测试通过

替代工作流：

• executing-plans - 使用并行会话，而不是在同一会话中执行

参见代码审查员模板：requesting-code-review/code-reviewer.md