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/保留/丢弃选项

开发流程图#

text

用户请求新功能
        │
        ▼
┌───────────────────────┐
│ 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. 设计在实现之先 — 不要跳到代码
2. 证据在声称之前 — 不要说我修好了，要运行验证
3. 根因在修复之先 — 不要猜，要调试
4. 测试在代码之先 — TDD，不是测试后补
5. 审查在集成之先 — 问题要早发现

OpenClaw 适配说明#

相比 Superpowers 原版：

维度原版OpenClaw 适配隔离机制git worktreegit branch + 目录Skill 加载Skill 工具读 SKILL.md 文件，语义触发SubagentTask 级联sessions_spawn 独立 sessionTodo 管理TodoWrite 工具内联检查表视觉辅助浏览器工具canvas 工具上下文传递模板注入session 历史 + 文件系统

与 AGENTS.md 的关系#

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

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

---

ClawHub 发布情况#

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

技能ClawHub Slug版本备注superpowers-overviewsuperpowers-overview1.0.0入口总览superpowers-tddsuperpowers-tdd1.0.0TDD 循环superpowers-verificationsuperpowers-verification1.0.0证据先行superpowers-systematic-debuggingsuperpowers-systematic-debugging1.0.0系统调试superpowers-brainstormingsuperpowers-brainstorming1.0.0设计流程superpowers-writing-planssuperpowers-writing-plans1.0.1实现计划superpowers-subagent-devsuperpowers-subagent-dev1.0.1子 agent 协调superpowers-finishing-branchsuperpowers-finishing-branch1.0.1分支收尾superpowers-isolated-workspacesuperpowers-isolated-workspace1.0.1隔离工作区superpowers-parallel-agentssuperpowers-parallel-agents1.0.1并行 agentsuperpowers-receiving-code-reviewopenclaw-receiving-code-review1.0.0⚠️ 原 slug 被占用，用 openclaw- 前缀superpowers-requesting-code-reviewopenclaw-requesting-code-review1.0.0⚠️ 原 slug 被占用，用 openclaw- 前缀superpowers-executing-plansopenclaw-executing-plans1.0.0⚠️ 原 slug 被占用，用 openclaw- 前缀