name: subagent-driven-developmentdescription: “在当次会话中执行包含独立任务的实施计划时使用”risk: criticalsource: communitydate_added: “2026-02-27”子代理驱动开发通过为每个任务派遣全新的子代理来执行计划每个任务后进行两阶段审查先做规格合规审查再做代码质量审查。核心原则每个任务使用全新子代理 两阶段审查先规格后质量 高质量、快速迭代何时使用digraph when_to_use { Have implementation plan? [shapediamond]; Tasks mostly independent? [shapediamond]; Stay in this session? [shapediamond]; subagent-driven-development [shapebox]; executing-plans [shapebox]; Manual execution or brainstorm first [shapebox]; Have implementation plan? - Tasks mostly independent? [labelyes]; Have implementation plan? - Manual execution or brainstorm first [labelno]; Tasks mostly independent? - Stay in this session? [labelyes]; Tasks mostly independent? - Manual execution or brainstorm first [labelno - tightly coupled]; Stay in this session? - subagent-driven-development [labelyes]; Stay in this session? - executing-plans [labelno - parallel session]; }与执行计划并行会话相比同一会话无需上下文切换每个任务使用全新子代理无上下文污染每个任务后进行两阶段审查先规格合规再代码质量迭代更快任务之间无需人工介入流程digraph process { rankdirTB; subgraph cluster_per_task { labelPer Task; Dispatch implementer subagent (./implementer-prompt.md) [shapebox]; Implementer subagent asks questions? [shapediamond]; Answer questions, provide context [shapebox]; Implementer subagent implements, tests, commits, self-reviews [shapebox]; Dispatch spec reviewer subagent (./spec-reviewer-prompt.md) [shapebox]; Spec reviewer subagent confirms code matches spec? [shapediamond]; Implementer subagent fixes spec gaps [shapebox]; Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md) [shapebox]; Code quality reviewer subagent approves? [shapediamond]; Implementer subagent fixes quality issues [shapebox]; Mark task complete in TodoWrite [shapebox]; } Read plan, extract all tasks with full text, note context, create TodoWrite [shapebox]; More tasks remain? [shapediamond]; Dispatch final code reviewer subagent for entire implementation [shapebox]; Use superpowers:finishing-a-development-branch [shapebox stylefilled fillcolorlightgreen]; Read plan, extract all tasks with full text, note context, create TodoWrite - Dispatch implementer subagent (./implementer-prompt.md); Dispatch implementer subagent (./implementer-prompt.md) - Implementer subagent asks questions?; Implementer subagent asks questions? - Answer questions, provide context [labelyes]; Answer questions, provide context - Dispatch implementer subagent (./implementer-prompt.md); Implementer subagent asks questions? - Implementer subagent implements, tests, commits, self-reviews [labelno]; Implementer subagent implements, tests, commits, self-reviews - Dispatch spec reviewer subagent (./spec-reviewer-prompt.md); Dispatch spec reviewer subagent (./spec-reviewer-prompt.md) - Spec reviewer subagent confirms code matches spec?; Spec reviewer subagent confirms code matches spec? - Implementer subagent fixes spec gaps [labelno]; Implementer subagent fixes spec gaps - Dispatch spec reviewer subagent (./spec-reviewer-prompt.md) [labelre-review]; Spec reviewer subagent confirms code matches spec? - Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md) [labelyes]; Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md) - Code quality reviewer subagent approves?; Code quality reviewer subagent approves? - Implementer subagent fixes quality issues [labelno]; Implementer subagent fixes quality issues - Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md) [labelre-review]; Code quality reviewer subagent approves? - Mark task complete in TodoWrite [labelyes]; Mark task complete in TodoWrite - More tasks remain?; More tasks remain? - Dispatch implementer subagent (./implementer-prompt.md) [labelyes]; More tasks remain? - Dispatch final code reviewer subagent for entire implementation [labelno]; Dispatch final code reviewer subagent for entire implementation - Use superpowers:finishing-a-development-branch; }提示词模板./implementer-prompt.md- 派遣实现者子代理./spec-reviewer-prompt.md- 派遣规格合规审查子代理./code-quality-reviewer-prompt.md- 派遣代码质量审查子代理示例工作流你我正在使用子代理驱动开发来执行这个计划。 [读取一次计划文件docs/plans/feature-plan.md] [提取全部 5 个任务含完整文本和上下文] [用所有任务创建 TodoWrite] 任务 1Hook 安装脚本 [获取任务 1 的文本和上下文已提取] [派遣带完整任务文本 上下文的实现子代理] 实现者在我开始之前——hook 应该安装在用户级还是系统级 你用户级~/.config/superpowers/hooks/ 实现者明白了。开始实现... [稍后] 实现者 - 实现了 install-hook 命令 - 添加了测试5/5 通过 - 自我审查发现自己遗漏了 --force 标志已添加 - 已提交 [派遣规格合规审查者] 规格审查者✅ 规格合规 - 满足所有需求无多余内容 [获取 git SHA派遣代码质量审查者] 代码审查者优势测试覆盖良好代码干净。问题无。已批准。 [标记任务 1 完成] 任务 2恢复模式 [获取任务 2 的文本和上下文已提取] [派遣带完整任务文本 上下文的实现子代理] 实现者[没有问题直接进行] 实现者 - 添加了 verify/repair 模式 - 8/8 测试通过 - 自我审查一切正常 - 已提交 [派遣规格合规审查者] 规格审查者❌ 问题 - 缺失进度报告规格要求每 100 项报告一次 - 多余添加了 --json 标志未被要求 [实现者修复问题] 实现者移除了 --json 标志添加了进度报告 [规格审查者再次审查] 规格审查者✅ 现在规格合规了 [派遣代码质量审查者] 代码审查者优势扎实。问题重要魔法数字100 [实现者修复] 实现者提取了 PROGRESS_INTERVAL 常量 [代码审查者再次审查] 代码审查者✅ 已批准 [标记任务 2 完成] ... [所有任务完成后] [派遣最终代码审查者] 最终审查者所有需求已满足可以合并 完成优势与手动执行相比子代理自然遵循 TDD每个任务全新上下文无混淆并行安全子代理互不干扰子代理可以提问工作前和工作期间都可以与执行计划相比同一会话无交接持续进展无需等待审查检查点自动进行效率提升无文件读取开销控制器提供完整文本控制器精确策划所需的上下文子代理事先获得完整信息问题在工作开始前提出而非之后质量门禁自我审查在交接前发现问题两阶段审查先规格合规再代码质量审查循环确保修复确实有效规格合规防止过度/不足构建代码质量确保实现构建良好成本更多的子代理调用每个任务 1 个实现者 2 个审查者控制器做更多准备工作预先提取所有任务审查循环增加迭代次数但能早期发现问题比以后调试更便宜危险信号绝不跳过审查规格合规或代码质量带着未修复的问题继续推进并行派遣多个实现子代理会产生冲突让子代理读取计划文件改为提供完整文本跳过场景设定上下文子代理需要理解任务所处位置忽视子代理的问题先回答再让他们继续接受规格合规上的差不多规格审查者发现问题 未完成跳过审查循环审查者发现问题 实现者修复 再次审查让实现者的自我审查替代真正的审查两者都需要在规格合规 ✅ 之前开始代码质量审查顺序错误在任一审查仍有未解决问题时推进到下一个任务如果子代理提问清晰完整地回答必要时提供额外上下文不要催促他们进入实现如果审查者发现问题由实现者同一子代理修复审查者再次审查重复直到批准不要跳过重新审查如果子代理任务失败派遣带具体指示的修复子代理不要尝试手动修复会造成上下文污染集成所需的工作流技能superpowers:writing-plans- 创建本技能执行的计划superpowers:requesting-code-review- 供审查子代理使用的代码审查模板superpowers:finishing-a-development-branch- 所有任务完成后完成开发子代理应使用superpowers:test-driven-development- 子代理对每个任务遵循 TDD替代工作流superpowers:executing-plans- 用于并行会话替代同会话执行局限性仅当任务与上述范围明确匹配时使用本技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必要的输入、权限、安全边界或成功标准请停下来询问澄清。
