核心用法
Superpowers 是一套面向复杂软件开发的强制性工作流引擎，采用子代理驱动架构实现从需求到交付的完整管道。用户通过自然语言触发构建意图后，系统自动进入五阶段管道：Brainstorm（需求探索与设计文档化）→ Writing Plans（任务级实施计划拆解）→ Subagent-Driven Build（TDD 子代理执行与双重审查）→ Systematic Debugging（根因驱动的故障修复）→ Finish Branch（测试验证与分支收尾）。
执行模式上，系统优先推荐 subagent-driven 模式：主代理通过 sessions_spawn 启动实现者子代理完成单任务（2-5 分钟粒度），随即调度规范审查子代理与代码质量审查子代理进行两阶段验证，形成「执行-审查-修复」闭环。TDD 为强制约束：每个任务必须先写失败测试，再实现功能，测试通过后立即提交。
显著优点
1. 流程刚性保障质量：通过「HARD GATE」设计（如无设计审批不写代码、无根因分析不修 bug）杜绝跳过关键步骤的冲动，在时间压力下维持工程纪律。
2. 子代理分工专业化：规范审查与质量审查分离，降低单点认知负荷，提升代码一致性。
3. 极小任务粒度：2-5 分钟任务单元降低认知负荷，配合频繁提交形成可回滚的安全网。
4. 故障处理系统化：四阶段调试流程（根因调查→模式分析→假设验证→修复确认）避免"试试这个"式的低效修复。
潜在缺点与局限性
- 启动成本高昂：简单功能（如单文件修改）强制走完整五阶段，产生显著流程税，官方明确排除"one-liner fixes"场景但仍需人工判断边界。
- 依赖子代理基础设施：需要
exec工具与sessions_spawn支持，环境兼容性受限。 - 同步阻塞开销：两阶段审查串行执行，可能拉长反馈周期；子代理调度失败时主流程停滞。
- 计划刚性：YAGNI 与 DRY 原则虽被强调，但过度拆分可能导致微观管理，抑制探索式编程。
适合人群
- 中大型功能开发（>30 分钟编码量）或需要多人协作对齐的复杂需求
- 对代码质量有硬性要求、愿意用流程换确定性的团队
- 需系统性根因分析的生产故障排查场景
常规风险
1. 子代理失控：任务描述模糊可能导致子代理实现偏离意图，需严格遵循 OpenClaw Dispatch Pattern 提供完整上下文。
2. 测试维护负担：强制 TDD 在快速原型阶段可能产生大量需同步更新的测试代码。
3. 文档债务累积：docs/plans/ 目录的设计文档与实施计划若缺乏治理，将成为弃档。
4. 用户决策疲劳：Brainstorm 阶段"一次一问"与分段审批虽提升质量，但高频交互可能消耗用户耐心。