name: subagent-driven-development description: 在当前会话中执行具有独立任务的实施计划时使用

子代理驱动开发

通过为每个任务调度新的子代理来执行计划，每个任务后进行两阶段审查：首先进行规范合规性审查，然后进行代码质量审查。

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

何时使用

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"];
}

vs. 执行计划（并行会话）：

同一会话（无上下文切换）
每个任务使用新子代理（无上下文污染）
每个任务后进行两阶段审查：首先规范合规性，然后代码质量
更快迭代（任务之间无人工循环）

流程

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：钩子安装脚本

[获取任务 1 文本和上下文（已提取）]
[使用完整任务文本 + 上下文调度实施子代理]

实施者："在我开始之前 - 钩子应该安装在用户级别还是系统级别？"

你："用户级别（~/.config/superpowers/hooks/）"

实施者："明白了。现在实施..."
[稍后] 实施者：
  - 实施了 install-hook 命令
  - 添加了测试，5/5 通过
  - 自我审查：发现我遗漏了 --force 标志，已添加
  - 已提交

[调度规范合规性审查者]
规范审查者：✅ 规范合规 - 满足所有要求，无额外内容

[获取 git SHA，调度代码质量审查者]
代码审查者：优势：良好的测试覆盖，干净。问题：无。批准。

[标记任务 1 完成]

任务 2：恢复模式

[获取任务 2 文本和上下文（已提取）]
[使用完整任务文本 + 上下文调度实施子代理]

实施者：[无问题，继续]
实施者：
  - 添加了 verify/repair 模式
  - 8/8 测试通过
  - 自我审查：一切良好
  - 已提交

[调度规范合规性审查者]
规范审查者：❌ 问题：
  - 缺少：进度报告（规范说"每 100 项报告一次"）
  - 额外：添加了 --json 标志（未请求）

[实施者修复问题]
实施者：删除了 --json 标志，添加了进度报告

[规范审查者再次审查]
规范审查者：✅ 现在规范合规

[调度代码质量审查者]
代码审查者：优势：扎实。问题（重要）：魔法数字（100）

[实施者修复]
实施者：提取了 PROGRESS_INTERVAL 常量

[代码审查者再次审查]
代码审查者：✅ 批准

[标记任务 2 完成]

...

[所有任务后]
[调度最终代码审查者]
最终审查者：满足所有要求，准备合并

完成！

优势

vs. 手动执行：

子代理自然遵循 TDD
每个任务使用新上下文（无混淆）
并行安全（子代理不干扰）
子代理可以提问（在工作之前和期间）

vs. 执行计划：

同一会话（无交接）
持续进展（无等待）
审查检查点自动

效率提升：

无文件读取开销（控制器提供完整文本）
控制器精确策划所需上下文
子代理预先获得完整信息
问题在工作开始前浮现（不是之后）

质量门控：

自我审查在交接前捕获问题
两阶段审查：规范合规性，然后代码质量
审查循环确保修复实际有效
规范合规性防止过度/不足构建
代码质量确保实施良好构建

成本：

更多子代理调用（每个任务实施者 + 2 个审查者）
控制器做更多准备工作（预先提取所有任务）
审查循环增加迭代
但早期捕获问题（比稍后调试更便宜）

危险信号

永远不要：

跳过审查（规范合规性或代码质量）
在未修复问题时继续
并行调度多个实施子代理（冲突）
让子代理读取计划文件（改为提供完整文本）
跳过场景设置上下文（子代理需要理解任务适合的位置）
忽略子代理问题（在让他们继续之前回答）
在规范合规性上接受"足够接近"（规范审查者发现问题 = 未完成）
跳过审查循环（审查者发现问题 = 实施者修复 = 再次审查）
让实施者自我审查替代实际审查（两者都需要）
在规范合规性 ✅ 之前开始代码质量审查（顺序错误）
在任一审查有未解决问题时移动到下一个任务

如果子代理提问：

清晰完整地回答
如果需要，提供额外上下文
不要催促他们实施

如果审查者发现问题：

实施者（同一子代理）修复它们
审查者再次审查
重复直到批准
不要跳过重新审查

如果子代理任务失败：

使用具体指令调度修复子代理
不要尝试手动修复（上下文污染）

集成

必需的工作流技能：

superpowers:writing-plans - 创建此技能执行的计划
superpowers:requesting-code-review - 审查者子代理的代码审查模板
superpowers:finishing-a-development-branch - 所有任务后完成开发

子代理应使用：

superpowers:test-driven-development - 子代理为每个任务遵循 TDD

替代工作流：

superpowers:executing-plans - 用于并行会话而不是同会话执行

subagent-driven-development

SKILL.md