用途
Subagent-Driven Development 用于在当前会话中执行实现计划,前提是计划中的任务基本相互独立。它的核心原则是:每个任务派发一个全新的子代理,并在每个任务后执行两阶段审查(先规格、后质量),从而实现高质量、快速迭代。
何时使用
根据技能给出的判断流程:
- 是否已有实现计划?没有则先手动执行或头脑风暴。
- 任务是否基本独立?若任务紧密耦合,则先手动执行或头脑风暴。
- 是否留在当前会话?是则使用 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 - 派发代码质量审查者子代理
使用方式示例
示例工作流中,使用者先读取计划文件(如 docs/plans/feature-plan.md),提取全部 5 个任务及其上下文,创建 TodoWrite。随后逐任务派发实施者子代理,实施者可能先提问(例如钩子应安装在用户级还是系统级),使用者回答后实施者实施、测试、提交并自审。接着派发规格审查者,若发现缺失或多余内容(例如缺少进度报告、多加了未要求的 --json 标志),实施者修复后重新审查。规格通过后派发代码质量审查者,若发现问题(例如魔法数字 100),实施者修复后重新审查,直至批准。所有任务完成后派发最终代码审查者。
优势
相对于手动执行:子代理自然遵循 TDD;每个任务使用全新上下文(避免混淆);可并行安全(子代理互不干扰);子代理可以提问(工作前和工作期间均可)。
相对于 Executing Plans:同一会话(无需交接);持续进展(无需等待);审查检查点自动化。
效率收益:无需读取文件的开销(控制器提供完整文本);控制器精确筛选所需上下文;子代理预先获得完整信息;问题在工作开始前浮现(而非之后)。
质量门禁:自审在交接前发现问题;两阶段审查(先规格符合性、后代码质量);审查循环确保修复真正生效;规格符合性防止过度或不足构建;代码质量确保实现质量良好。
成本:更多子代理调用(每个任务一个实施者加两个审查者);控制器需要更多准备工作(预先提取所有任务);审查循环增加迭代次数;但能尽早发现问题(比后期调试更便宜)。
限制与红线
技能明确列出不应做的事项:
- 绝不跳过审查(规格符合性或代码质量)。
- 绝不带着未修复的问题继续。
- 绝不并行派发多个实施者子代理(会冲突)。
- 绝不让子代理读取计划文件(应提供完整文本)。
- 绝不跳过场景设定上下文(子代理需要理解任务所处位置)。
- 绝不忽略子代理的提问(先回答再让其继续)。
- 绝不接受规格符合性上的“差不多”(规格审查者发现问题即视为未完成)。
- 绝不跳过审查循环(审查者发现问题 = 实施者修复 = 再次审查)。
- 绝不让实施者自审替代实际审查(两者都需要)。
- 绝不在规格符合性通过前开始代码质量审查(顺序错误)。
- 绝不在任一审查存在未解决问题时进入下一个任务。
若子代理提问:清晰完整地回答,必要时提供额外上下文,不要催促其进入实施。
若审查者发现问题:由同一实施者子代理修复,审查者再次审查,重复直至批准,不要跳过复审。
若子代理任务失败:派发修复子代理并给出具体指令,不要尝试手动修复(会造成上下文污染)。
集成
必需的工作流技能:
- superpowers:writing-plans - 创建本技能所执行的计划
- superpowers:requesting-code-review - 供审查者子代理使用的代码审查模板
- superpowers:finishing-a-development-branch - 所有任务完成后完成开发
子代理应使用:
- superpowers:test-driven-development - 子代理对每个任务遵循 TDD
替代工作流:
- superpowers:executing-plans - 用于并行会话而非同一会话执行
其他限制
仅当任务明确符合上述范围时才使用本技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必需输入、权限、安全边界或成功标准,应停止并请求澄清。