用途
Subagent-Driven Development 用于在当前会话中执行实现计划,适合任务之间大多相互独立的场景。它通过为每个任务派发全新的子代理,并在任务之间进行代码审查,实现高质量与快速迭代。
核心原则:每个任务使用全新子代理 + 任务之间进行审查 = 高质量、快速迭代。
与「执行计划(并行会话)」的对比
- 同一会话(无上下文切换)
- 每个任务使用全新子代理(无上下文污染)
- 每个任务后进行代码审查(及早发现问题)
- 迭代更快(任务之间无需人工介入)
适用场景
- 希望留在当前会话中
- 任务大多相互独立
- 希望持续进展并带有质量关卡
不适用场景
- 需要先审查计划(改用 executing-plans)
- 任务紧密耦合(手动执行更合适)
- 计划需要修订(先进行头脑风暴)
流程
1. 加载计划
读取计划文件,使用 TodoWrite 创建包含所有任务的清单。
2. 使用子代理执行任务
对每个任务派发全新子代理:
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
子代理返回工作摘要。
3. 审查子代理的工作
派发代码审查子代理:
Task tool (superpowers: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. 应用审查反馈
如果发现问题:
- 立即修复严重问题
- 在下一个任务前修复重要问题
- 记录次要问题
如有需要,派发后续子代理:
"Fix issues from code review: [list issues]"
5. 标记完成,进入下一个任务
在 TodoWrite 中将任务标记为已完成,进入下一个任务,重复步骤 2-5。
6. 最终审查
所有任务完成后,派发最终代码审查者:
- 审查整个实现
- 检查所有计划要求是否满足
- 验证整体架构
7. 完成开发
最终审查通过后:
宣布:"I'm using the finishing-a-development-branch skill to complete this work."
必需子技能:使用 superpowers:finishing-a-development-branch
按照该技能验证测试、呈现选项、执行选择。
示例工作流
你:我正在使用 Subagent-Driven Development 执行此计划。
[加载计划,创建 TodoWrite]
任务 1:钩子安装脚本
[派发实现子代理] 子代理:实现了带测试的 install-hook,5/5 通过
[获取 git SHA,派发代码审查者] 审查者:优点:测试覆盖良好。问题:无。就绪。
[标记任务 1 完成]
任务 2:恢复模式
[派发实现子代理] 子代理:添加了 verify/repair,8/8 测试通过
[派发代码审查者] 审查者:优点:扎实。问题(重要):缺少进度报告
[派发修复子代理] 修复子代理:每 100 次对话添加进度
[验证修复,标记任务 2 完成]
...
[所有任务完成后] [派发最终代码审查者] 最终审查者:所有要求已满足,可以合并
完成!
优势
相对于手动执行:
- 子代理自然遵循 TDD
- 每个任务使用全新上下文(无混淆)
- 并行安全(子代理互不干扰)
相对于执行计划:
- 同一会话(无需交接)
- 持续进展(无需等待)
- 审查检查点自动化
成本:
- 更多子代理调用
- 但能及早发现问题(比事后调试更便宜)
危险信号
绝不要:
- 跳过任务之间的代码审查
- 在严重问题未修复的情况下继续
- 并行派发多个实现子代理(会冲突)
- 未阅读计划任务就实现
如果子代理任务失败:
- 派发带有具体指令的修复子代理
- 不要尝试手动修复(会污染上下文)
集成
必需的工作流技能:
- writing-plans - 必需:创建此技能执行的计划
- requesting-code-review - 必需:每个任务后审查(见步骤 3)
- finishing-a-development-branch - 必需:所有任务后完成开发(见步骤 7)
子代理必须使用:
- test-driven-development - 子代理为每个任务遵循 TDD
替代工作流:
- executing-plans - 用于并行会话而非同一会话执行
参见代码审查者模板:requesting-code-review/code-reviewer.md