Subagent-Driven Development

子 Agent 驱动开发

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

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

概述

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

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

适用场景：

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

不适用场景：

• 需要先审查计划（使用执行计划）
• 各任务紧密耦合（手动执行更合适）
• 计划需要修订（先进行头脑风暴）

流程

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 skills/collaboration/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. 完成开发

最终审查通过后：

• 宣布：“我将使用「完成开发分支」技能来完成这项工作。”
• 切换到 skills/collaboration/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，并提供具体指示
• 不要尝试手动修复（会造成上下文污染）

集成

可搭配使用：

• skills/collaboration/writing-plans（创建计划）
• skills/collaboration/requesting-code-review（审查模板）
• skills/testing/test-driven-development（子 Agent 遵循此流程）

可替代：

• skills/collaboration/executing-plans（并行会话）

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