用途
Subagent-Driven Development 用于在当前会话中执行实施计划。它的做法是:把实施计划拆成任务,为每个任务派发一个全新的子代理(subagent)来实施;每个任务完成后进行两阶段评审:先做规格符合性评审,再做代码质量评审。核心原则是“每任务新子代理 + 两阶段评审(先规格、后质量)= 高质量、快速迭代”。
何时使用
资料给出了一棵判断树:
- 是否有实施计划?没有则先手动执行或先做头脑风暴。
- 任务是否基本独立?若任务紧耦合,则先手动执行或先做头脑风暴。
- 是否留在本会话中执行?是则使用 subagent-driven-development;否则(在并行会话中执行)使用 executing-plans。
与 Executing Plans(并行会话)相比,本技能的特点是:同一会话中执行(无需上下文切换)、每任务使用全新子代理(避免上下文污染)、每任务后两阶段评审(先规格符合性后代码质量)、迭代更快(任务之间无需人工介入)。
主要流程
- 读取计划,提取所有任务的完整文本,记录上下文,创建 TodoWrite。
- 对每个任务:派发实施子代理(使用 ./implementer-prompt.md)。
- 若实施子代理提问,则回答问题并提供上下文,然后再让其继续。
- 实施子代理实施、测试、提交并自审。
- 派发规格评审子代理(使用 ./spec-reviewer-prompt.md),确认代码与规格一致;若不一致,实施子代理修复规格缺口,然后重新评审。
- 规格通过后,派发代码质量评审子代理(使用 ./code-quality-reviewer-prompt.md);若不通过,实施子代理修复质量问题,然后重新评审。
- 质量评审通过后,在 TodoWrite 中标记该任务完成。
- 若还有任务,继续下一个任务;全部完成后,派发最终代码评审子代理对整个实现进行评审,然后使用 superpowers:finishing-a-development-branch。
提示词模板
- ./implementer-prompt.md:派发实施子代理
- ./spec-reviewer-prompt.md:派发规格符合性评审子代理
- ./code-quality-reviewer-prompt.md:派发代码质量评审子代理
示例工作流(资料示例)
资料给出一个包含 5 个任务的计划示例。任务 1(钩子安装脚本):派发实施子代理后,子代理先询问钩子应安装在用户级还是系统级,得到答复后实施,添加测试 5/5 通过,自审发现遗漏 --force 标志并补上,然后提交;规格评审通过;代码质量评审通过后标记完成。任务 2(恢复模式):实施子代理添加 verify/repair 模式,8/8 测试通过并提交;规格评审发现缺少进度报告(规格要求“每 100 项报告一次”)且多加了未要求的 --json 标志;实施子代理修复后重新评审通过;代码质量评审指出魔法数字 100,实施子代理提取 PROGRESS_INTERVAL 常量后重新评审通过。全部任务完成后派发最终代码评审,确认满足要求、可合并。
优势(资料陈述)
相比手动执行:子代理自然遵循 TDD;每任务全新上下文(避免混淆);并行安全(子代理互不干扰);子代理可在工作开始前和工作过程中提问。
相比 Executing Plans:同一会话(无需交接);持续进展(无需等待);评审检查点自动化。
效率方面:无需文件读取开销(控制器提供完整文本);控制器精确筛选所需上下文;子代理一开始就获得完整信息;问题在工作开始前浮现。
质量门方面:自审在交接前发现问题;两阶段评审先规格后质量;评审循环确保修复真正生效;规格符合性防止过度或不足实现;代码质量确保实现良好。
成本:每个任务更多子代理调用(实施者 + 2 个评审者);控制器准备工作更多(需预先提取所有任务);评审循环增加迭代次数;但能尽早发现问题(比后期调试更便宜)。
红线(禁止事项)
- 不得跳过任一评审(规格符合性或代码质量)。
- 不得在问题未修复时继续。
- 不得并行派发多个实施子代理(会冲突)。
- 不得让子代理自己读计划文件(应提供完整文本)。
- 不得省略场景铺垫上下文。
- 不得忽视子代理的提问(应先回答再让其继续)。
- 不得在规格符合性上接受“差不多”(评审者发现问题即未完成)。
- 不得跳过评审循环(发现问题 = 实施者修复 = 再次评审)。
- 不得用实施者自审替代正式评审(两者都需要)。
- 不得在规格符合性通过前开始代码质量评审(顺序错误)。
- 不得在任一评审存在未解决问题时进入下一任务。
若子代理提问:清晰完整地回答,必要时补充上下文,不要催促其进入实施。若评审者发现问题:由同一实施子代理修复,评审者再次评审,重复直至通过,不要跳过复审。若子代理任务失败:派发修复子代理并给出具体指示,不要手动修复(避免上下文污染)。
集成
必需的配合技能:superpowers:writing-plans(创建本技能执行的计划)、superpowers:requesting-code-review(评审子代理的代码评审模板)、superpowers:finishing-a-development-branch(全部任务完成后收尾)。子代理应使用 superpowers:test-driven-development(每个任务遵循 TDD)。替代工作流:若在并行会话中执行而非同会话执行,使用 superpowers:executing-plans。