子代理驱动开发

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

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

何时使用

dot
digraph whentouse {
有实施计划？ [shape=diamond];
任务大多独立？ [shape=diamond];
留在当前会话？ [shape=diamond];
子代理驱动开发 [shape=box];
执行计划 [shape=box];
手动执行或先进行头脑风暴 [shape=box];

有实施计划？ -> 任务大多独立？ [label=是];
有实施计划？ -> 手动执行或先进行头脑风暴 [label=否];
任务大多独立？ -> 留在当前会话？ [label=是];
任务大多独立？ -> 手动执行或先进行头脑风暴 [label=否 - 紧密耦合];
留在当前会话？ -> 子代理驱动开发 [label=是];
留在当前会话？ -> 执行计划 [label=否 - 并行会话];
}

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

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

流程

dot
digraph process {
rankdir=TB;

subgraph clusterpertask {
label=每个任务;
分派实施子代理 (./implementer-prompt.md) [shape=box];
实施子代理提问？ [shape=diamond];
回答问题，提供上下文 [shape=box];
实施子代理实施、测试、提交、自我审查 [shape=box];
分派规范审查子代理 (./spec-reviewer-prompt.md) [shape=box];
规范审查子代理确认代码符合规范？ [shape=diamond];
实施子代理修复规范差距 [shape=box];
分派代码质量审查子代理 (./code-quality-reviewer-prompt.md) [shape=box];
代码质量审查子代理批准？ [shape=diamond];
实施子代理修复质量问题 [shape=box];
在TodoWrite中标记任务完成 [shape=box];
}

读取计划，提取所有任务及其完整文本，记录上下文，创建TodoWrite [shape=box];
还有剩余任务？ [shape=diamond];
分派最终代码审查子代理审查整个实现 [shape=box];
使用超级能力：完成开发分支 [shape=box style=filled fillcolor=lightgreen];

读取计划，提取所有任务及其完整文本，记录上下文，创建TodoWrite -> 分派实施子代理 (./implementer-prompt.md);
分派实施子代理 (./implementer-prompt.md) -> 实施子代理提问？;
实施子代理提问？ -> 回答问题，提供上下文 [label=是];
回答问题，提供上下文 -> 分派实施子代理 (./implementer-prompt.md);
实施子代理提问？ -> 实施子代理实施、测试、提交、自我审查 [label=否];
实施子代理实施、测试、提交、自我审查 -> 分派规范审查子代理 (./spec-reviewer-prompt.md);
分派规范审查子代理 (./spec-reviewer-prompt.md) -> 规范审查子代理确认代码符合规范？;
规范审查子代理确认代码符合规范？ -> 实施子代理修复规范差距 [label=否];
实施子代理修复规范差距 -> 分派规范审查子代理 (./spec-reviewer-prompt.md) [label=重新审查];
规范审查子代理确认代码符合规范？ -> 分派代码质量审查子代理 (./code-quality-reviewer-prompt.md) [label=是];
分派代码质量审查子代理 (./code-quality-reviewer-prompt.md) -> 代码质量审查子代理批准？;
代码质量审查子代理批准？ -> 实施子代理修复质量问题 [label=否];
实施子代理修复质量问题 -> 分派代码质量审查子代理 (./code-quality-reviewer-prompt.md) [label=重新审查];
代码质量审查子代理批准？ -> 在TodoWrite中标记任务完成 [label=是];
在TodoWrite中标记任务完成 -> 还有剩余任务？;
还有剩余任务？ -> 分派实施子代理 (./implementer-prompt.md) [label=是];
还有剩余任务？ -> 分派最终代码审查子代理审查整个实现 [label=否];
分派最终代码审查子代理审查整个实现 -> 使用超级能力：完成开发分支;
}

提示模板

• - ./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文本和上下文（已提取）]
[分派实施子代理，附带完整任务文本和上下文]

实施者：[无问题，直接进行]
实施者：
- 添加了验证/修复模式
- 8/8测试通过
- 自我审查：一切正常
- 已提交

[分派规范合规性审查]
规范审查者：❌ 问题：
- 缺少：进度报告（规范要求每100项报告一次）
- 多余：添加了--json标志（未要求）

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

[规范审查者重新审查]
规范审查者：✅ 现在符合规范

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

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

[代码审查者重新审查]
代码审查者：✅ 已批准

[标记任务2完成]

...

[所有任务完成后]
[分派最终代码审查]
最终审查者：所有要求已满足，准备合并

完成！

优势

与手动执行对比：

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

与执行计划对比：

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

效率提升：

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

质量关卡：

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

成本：

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

警示标志

绝对禁止：

• - 未经用户明确同意在主/主分支上开始实施
• 跳过审查（规范合规性或代码质量）
• 在问题未修复的情况下继续推进
• 并行分派多个实施子代理（导致冲突）
• 让子代理读取计划文件（