前言¶
写代码时最容易出问题的并不是”写不出来”，而是写之前没想清楚就动手：代码越写越乱、测试补不回去、改一个 bug 引出另一个。Superpowers Dev Workflow 把一整套流程固化成一个 Skill，让代理在动手前先头脑风暴、出设计、写计划，再逐任务用测试驱动开发（TDD）实现，每一步都有硬性门槛。
下面介绍这个 Skill。
这是什么¶
Superpowers Dev Workflow 是一个面向编程任务的 Skill，坐标 @wlshlad85/superpowers，发布在 ClawHub，发布者 wlshlad85，当前版本 v1.0.0，许可证 MIT-0。它改编自 obra/superpowers，是给 OpenClaw 代理用的强制工作流，不是可选建议。
定位一句话：以规格为首、测试驱动开发、子代理驱动的软件开发工作流。它解决的是代理”接到任务就直接改代码”导致的返工和质量不可控。
Skill 页面给出的统计为：评分 100000、下载 35670、安装 735（来源：SkillHub 抓取资料）；安全审计 Pass，最近一次更新约 1 个月前。另有 SkillHub 镜像地址 https://api.skillhub.cn/org-k6bcf2fv/superpowers。
核心流程¶
整个 Skill 围绕一条固定流水线：
Idea → Brainstorm → Plan → Subagent-Driven Build (TDD) → Code Review → Finish Branch
每个编码任务都走这条流水线，官方说明明确写着：”Too simple to need a design” is always wrong——再简单的任务也要先出设计。
分五个阶段：
- Phase 1 Brainstorming（头脑风暴）：用户想构建东西时触发，在碰任何代码之前激活。先探索项目上下文（文件、文档、最近提交），然后一次只问一个问题、优先用选择题，提出 2–3 个方案并说明权衡和推荐，分节呈现设计并在每节后取得确认。设计文档写入
docs/plans/YYYY-MM-DD-<topic>-design.md并提交。硬门槛：用户批准设计前不写任何代码。 - Phase 2 Writing Plans（写计划）：设计通过后激活。产出逐任务的实现计划，每个任务控制在 2–5 分钟：写测试 → 看它失败 → 实现 → 看它通过 → 提交。计划保存为
docs/plans/YYYY-MM-DD-<feature>.md。保存后提供两种执行模式：子代理驱动（当前会话）或用户手动执行。 - Phase 3 Subagent-Driven Development（子代理驱动开发）：计划已存在且用户选择子代理模式时触发。每个任务的循环是：用
sessions_spawn派一个实现子代理 → 等它报告完成 → 派规格审查子代理确认代码符合规格 → 派代码质量审查子代理批准质量 → 修复问题并按需复审 → 标记任务完成、进入下一个 → 最后派整体代码审查者。每个任务都强制 TDD。 - Phase 4 Systematic Debugging（系统化调试）：出现 bug、测试失败或异常行为时触发。硬门槛：没有先做根因调查不得修复。分四步：根因调查（读错误、复现、看近期改动、追踪数据流）→ 模式分析（找能工作的例子、比较、找差异）→ 假设与测试（一次只假设一个，用测试证明或否定）→ 修复与验证（在根上修而不是治症状，验证修复不破坏其他东西）。
- Phase 5 Finishing a Branch（收尾分支）：所有任务完成、所有测试通过时触发。先确认所有测试通过，确定目标 base 分支，然后给出四个选项：本地合并 / push 加 PR / 保留 / 丢弃，执行用户选择并清理。
安装与启用¶
这是给 OpenClaw 代理用的 Skill，官方安装命令如下：
openclaw skills install @wlshlad85/superpowers
页面同时给出另一种安装途径 npx skills。Skill 声明需要 exec 工具和 sessions_spawn，缺这两样无法完整跑通子代理流程。
需要说明：该 Skill 面向 OpenClaw 代理。任务线索中提到的 Cursor、Codex CLI、Claude Code 等宿主，官方资料里没有对应的安装或配置说明，此处不做展开。
典型用法¶
官方文档给出了子代理派发的固定格式，派发实现者或审查者时使用 sessions_spawn：
Goal: [一句话目标]
Context: [为什么重要，对应哪个计划文件]
Files: [确切路径]
Constraints: [不要做什么——禁止范围蔓延、只做 TDD]
Verify: [如何确认成功——测试通过，具体命令]
Task text: [粘贴计划中的完整任务]
用这段文本作为 prompt 运行 sessions_spawn，子代理会自动报告结果。
触发时机（官方列出）：
- 构建任何新功能或应用：触发头脑风暴 → 规划 → 子代理执行循环
- 调试 bug 或测试失败：触发系统化根因流程
- 用户说 “let’s build”、”help me plan”、”I want to add X”、”this is broken”
- 完成一个 feature 分支：触发测试验证 + 合并/PR 选项
适用场景与注意¶
适合：需要构建新功能或应用、需要系统化排查问题、需要把实现拆成可验证小步的编码任务。它强制 TDD 和频繁提交，适合对正确性要求高、愿意先花时间做设计的项目。
限制（官方明确列为 NOT for）：
- 一行式的小修复——直接编辑即可，不必走全流程
- 读代码
- 非代码任务
几条需要留意的原则：头脑风暴时一次只问一个问题；TDD 永远成立，先写失败的测试，测试之前写的代码要删掉；YAGNI，从设计中去掉不必要的功能；DRY，不允许重复；系统化优于临时应付，尤其在时间紧张时；证据优于宣称，声明成功前先验证；每个绿色测试后提交。
此外，依赖 exec 工具和 sessions_spawn 的宿主才能完整执行；若宿主不支持子代理派发，Phase 3 的子代理驱动模式无法运行，只能退回手动执行模式。
结尾¶
Superpowers Dev Workflow 的价值不在于提供了多少新能力，而是把”先设计、再计划、测试先行、根因优先”这套流程变成代理无法跳过的硬步骤，用门槛约束来减少返工。如果你的编码任务需要长期维护和可验证的正确性，可以按上面的流水线逐步套用。
官方地址：
- ClawHub 上游：https://clawhub.ai/wlshlad85/superpowers
- SkillHub 镜像：https://api.skillhub.cn/org-k6bcf2fv/superpowers
