子代理驱动的 TDD 全流程引擎

Spec-first TDD 开发流程引擎，通过子代理协作实现从需求分析到代码交付的全自动化软件构建，强制测试驱动与代码审查，适合复杂功能开发。

基本信息

• 技能名称?Superpowers Dev Workflow
• 中文名称?子代理驱动的 TDD 全流程引擎
• 作者?wlshlad85
• 分类?专业技能
• 版本?1.0.0
• 标签?tdd, subagent, workflow, code-review, spec-driven, testing, software-development, project-management

使用方法

使用说明
核心用法
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 分钟编码量）或需要多人协作对齐的复杂需求
   对代码质量有硬性要求、愿意用流程换确定性的团队
   需系统性根因分析的生产故障排查场景
   常规风险
5. 子代理失控 ：任务描述模糊可能导致子代理实现偏离意图，需严格遵循 OpenClaw Dispatch Pattern 提供完整上下文。
6. 测试维护负担 ：强制 TDD 在快速原型阶段可能产生大量需同步更新的测试代码。
7. 文档债务累积 ： docs/plans/ 目录的设计文档与实施计划若缺乏治理，将成为弃档。
8. 用户决策疲劳 ：Brainstorm 阶段"一次一问"与分段审批虽提升质量，但高频交互可能消耗用户耐心。