企业官网建设流程全解析

name: subagent-driven-development
description: “在当次会话中执行包含独立任务的实施计划时使用”
risk: critical
source: community
date_added: “2026-02-27”

子代理驱动开发

通过为每个任务派遣全新的子代理来执行计划，每个任务后进行两阶段审查：先做规格合规审查，再做代码质量审查。

核心原则：每个任务使用全新子代理 + 两阶段审查（先规格后质量）= 高质量、快速迭代

何时使用

digraph when_to_use { "Have implementation plan?" [shape=diamond]; "Tasks mostly independent?" [shape=diamond]; "Stay in this session?" [shape=diamond]; "subagent-driven-development" [shape=box]; "executing-plans" [shape=box]; "Manual execution or brainstorm first" [shape=box]; "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"]; "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"]; "Tasks mostly independent?" -> "Stay in this session?" [label="yes"]; "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"]; "Stay in this session?" -> "subagent-driven-development" [label="yes"]; "Stay in this session?" -> "executing-plans" [label="no - parallel session"]; }

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

• 同一会话（无需上下文切换）
• 每个任务使用全新子代理（无上下文污染）
• 每个任务后进行两阶段审查：先规格合规，再代码质量
• 迭代更快（任务之间无需人工介入）

流程

digraph process { rankdir=TB; subgraph cluster_per_task { label="Per Task"; "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box]; "Implementer subagent asks questions?" [shape=diamond]; "Answer questions, provide context" [shape=box]; "Implementer subagent implements, tests, commits, self-reviews" [shape=box]; "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box]; "Spec reviewer subagent confirms code matches spec?" [shape=diamond]; "Implementer subagent fixes spec gaps" [shape=box]; "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box]; "Code quality reviewer subagent approves?" [shape=diamond]; "Implementer subagent fixes quality issues" [shape=box]; "Mark task complete in TodoWrite" [shape=box]; } "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box]; "More tasks remain?" [shape=diamond]; "Dispatch final code reviewer subagent for entire implementation" [shape=box]; "Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen]; "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" [label="yes"]; "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)"; "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"]; "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" [label="no"]; "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"]; "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"]; "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" [label="no"]; "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"]; "Code quality reviewer subagent approves?" -> "Mark task complete in TodoWrite" [label="yes"]; "Mark task complete in TodoWrite" -> "More tasks remain?"; "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"]; "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"]; "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] 任务 1：Hook 安装脚本 [获取任务 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- 用于并行会话，替代同会话执行

局限性

• 仅当任务与上述范围明确匹配时使用本技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停下来询问澄清。