Superpowers 开发方法论 — OpenClaw 移植版

这是什么

Superpowers 是一套为 AI coding agent 设计的结构化开发方法论，核心是：

Agent 不应一上来就写代码，而应该先理解需求 → 设计方案 → 制定计划 → TDD 实现 → 审查代码 → 收尾。

本技能套件将 Superpowers 移植到 OpenClaw Agent Runtime，针对 OpenClaw 的工具模型做了适配。

技能套件（9个）

🚀 入门

技能	何时用	做什么
superpowers-overview（这个）	不知道从哪里开始	查看套件全貌和入口
superpowers-brainstorming

要做新功能/改东西之前 | 探索需求，提出方案，获得批准 | | superpowers-writing-plans | 有了设计，需要具体实现计划 | 写小粒度任务计划 |

🔨 执行

技能	何时用	做什么
superpowers-isolated-workspace	开始实现前	创建隔离 git 分支，建立干净起点
superpowers-subagent-dev

有实现计划，任务独立 | 派发 subagent 执行任务，两阶段审查 | | superpowers-parallel-agents | 有多个独立问题要并行处理 | 并行派发多个 subagent 同时工作 | | superpowers-tdd | 写任何实现代码之前 | 强制 RED-GREEN-REFACTOR 循环 | | superpowers-executing-plans | 在本 session 顺序执行计划任务 | 按批次执行，有审查检查点 |

✅ 质量保障

技能	何时用	做什么
superpowers-verification	声称任何完成了/通过了之前	强制证据先行，必须运行验证命令
superpowers-systematic-debugging

遇到 bug/测试失败/意外行为 | 四阶段调试：根因→模式→假设→修复 | | openclaw-requesting-code-review | 完成任务/重大功能/merge 之前 | 派发审查捕获问题 | | openclaw-receiving-code-review | 收到代码审查反馈时 | 验证后实现，合理反驳 | | superpowers-finishing-branch | 实现完成，测试通过，要收尾 | 展示 merge/PR/保留/丢弃选项 |

开发流程图

用户请求新功能
│
▼
┌───────────────────────┐
│ superpowers-brainstorming │
│ 探索需求 + 设计方案 │
└───────────┬───────────┘
│ 主人批准设计
▼
┌───────────────────────────┐
│ superpowers-isolated-workspace │
│ 创建隔离分支 + 干净基线 │
└───────────┬───────────────┘
│
▼
┌───────────────────────┐
│ superpowers-writing-plans │
│ 写实现计划（任务清单） │
└───────────┬───────────┘
│
▼
┌───────┴───────┐
│ 选择执行模式 │
└───────┬───────┘
│
┌───────┴───────────────┐
│ │
▼ ▼
┌────────────────┐ ┌─────────────────────┐
│ subagent-dev │ │ executing-plans │
│（推荐） │ │（本 session 顺序） │
│ 每个任务派发 │ │ 按批次执行 │
│ subagent+审查 │ │ 中间审查检查点 │
└───────┬────────┘ └──────────┬──────────┘
│ │
└─────────┬───────────┘
│
▼
┌─────────────────────┐
│superpowers-finishing│
│-branch │
│ merge/PR/保留/丢弃 │
└─────────────────────┘

日常使用决策

我要做 X 功能
→ superpowers-brainstorming → superpowers-writing-plans → superpowers-subagent-dev

我要修 bug
→ superpowers-systematic-debugging → superpowers-tdd → superpowers-verification

有 3 个独立的测试失败
→ superpowers-parallel-agents → 分别并行调查 → 整合

代码写完了准备提交
→ superpowers-verification → openclaw-requesting-code-review → superpowers-finishing-branch

核心原则

1. 1. 设计在实现之先 — 不要跳到代码
2. 证据在声称之前 — 不要说我修好了，要运行验证
3. 根因在修复之先 — 不要猜，要调试
4. 测试在代码之先 — TDD，不是测试后补
5. 审查在集成之先 — 问题要早发现

OpenClaw 适配说明

相比 Superpowers 原版：

维度	原版	OpenClaw 适配
隔离机制	git worktree	git branch + 目录
Skill 加载

Skill 工具 | 读 SKILL.md 文件，语义触发 |
| Subagent | Task 级联 | sessions_spawn 独立 session |
| Todo 管理 | TodoWrite 工具 | 内联检查表 |
| 视觉辅助 | 浏览器工具 | canvas 工具 |
| 上下文传递 | 模板注入 | session 历史 + 文件系统 |

与 AGENTS.md 的关系

Superpowers 技能套件补充而非替代 AGENTS.md：

• - AGENTS.md = 我是谁、我的工作区、我的记忆系统
• Superpowers = 结构化开发流程和工程质量规范
• 两者协同：先了解我是谁，再用正确方法做事

---

ClawHub 发布情况

所有 13 个技能均已发布至 ClawHub：

技能	ClawHub Slug	版本	备注
superpowers-overview	superpowers-overview	1.0.0	入口总览
superpowers-tdd

superpowers-tdd | 1.0.0 | TDD 循环 |
| superpowers-verification | superpowers-verification | 1.0.0 | 证据先行 |
| superpowers-systematic-debugging | superpowers-systematic-debugging | 1.0.0 | 系统调试 |
| superpowers-brainstorming | superpowers-brainstorming | 1.0.0 | 设计流程 |
| superpowers-writing-plans | superpowers-writing-plans | 1.0.1 | 实现计划 |
| superpowers-subagent-dev | superpowers-subagent-dev | 1.0.1 | 子 agent 协调 |
| superpowers-finishing-branch | superpowers-finishing-branch | 1.0.1 | 分支收尾 |
| superpowers-isolated-workspace | superpowers-isolated-workspace | 1.0.1 | 隔离工作区 |
| superpowers-parallel-agents | superpowers-parallel-agents | 1.0.1 | 并行 agent |
| superpowers-receiving-code-review | openclaw-receiving-code-review | 1.0.0 | ⚠️ 原 slug 被占用，用 openclaw- 前缀 |
| superpowers-requesting-code-review | openclaw-requesting-code-review | 1.0.0 | ⚠️ 原 slug 被占用，用 openclaw- 前缀 |
| superpowers-executing-plans | openclaw-executing-plans | 1.0.0 | ⚠️ 原 slug 被占用，用 openclaw- 前缀 |