superpowers-overview

# 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. **设计在实现之先** — 不要跳到代码
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- 前缀 |