---
title: Superpowers 方法论与 Agent-Based 项目整合
author: shenwei
tags: [multi-agent, superpowers]
---
# Superpowers 方法论与 Agent-Based 项目整合

> **创建时间：** 2026-04-05
> **来源：** 与比利哥的讨论
> **标签：** #方法论 #multi-agent #superpowers

---

## 一、Superpowers 是什么

Superpowers 是由 Jesse Vincent（Best Practical）构建的 **软件编码工作流框架**，专为 AI 编码代理（Claude Code、Cursor、Codex、OpenCode）设计。

**核心理念：**"Don't just jump in — step back, question, plan, then execute."

---

## 二、核心工作流（Basic Workflow）

| 阶段 | 触发时机 | 关键产出 |
|---|---|---|
| `brainstorming` | 写代码前 | 澄清意图、设计文档 |
| `using-git-worktrees` | 设计确认后 | 隔离工作分支 |
| `writing-plans` | 设计定稿后 | 可执行的小任务清单（2-5分钟/项） |
| `subagent-driven-development` / `executing-plans` | 计划就绪 | 并行分发子任务、两阶段审查 |
| `test-driven-development` | 实现过程中 | RED-GREEN-REFACTOR 循环 |
| `requesting-code-review` | 任务间 | 按严重级别报告问题 |
| `finishing-a-development-branch` | 任务完成 | 测试验证 + PR/合并选项 |

---

## 三、核心技能清单

### Testing
- `test-driven-development` — RED-GREEN-REFACTOR 循环

### Debugging
- `systematic-debugging` — 4步根因分析
- `verification-before-completion` — 确保真正修复

### Collaboration
- `brainstorming` — 苏格拉底式设计精炼
- `writing-plans` — 详细实现计划
- `executing-plans` — 分批执行 + 检查点
- `dispatching-parallel-agents` — 并发子任务工作流
- `requesting-code-review` — 审查前检查清单
- `receiving-code-review` — 响应反馈
- `using-git-worktrees` — 并行开发分支
- `finishing-a-development-branch` — 合并/PR决策
- `subagent-driven-development` — 两阶段审查（规格合规 → 代码质量）

### Meta
- `writing-skills` — 创建新技能
- `using-superpowers` — 技能系统入门

---

## 四、哲学原则

- **Test-Driven Development** — 先写测试，永远
- **Systematic over ad-hoc** — 流程优于猜测
- **Complexity reduction** — 简洁是首要目标
- **Evidence over claims** — 验证后才算成功

---

## 五、对 OpenClaw Agent 矩阵的映射

### 5.1 Agent 类型与适用度

| Agent 类型 | 示例 | Superpowers 适用度 |
|---|---|---|
| **编码型** | xingjiang (星匠) | ✅ 高 — 直接可用 |
| **运维型** | xingyao (星曜)、yunhan | ✅ 中 — 部分技能适用 |
| **协调型** | xingshu (星枢/我) | ❌ 低 — 方法论而非执行框架 |

### 5.2 技能映射对照

| Superpowers 通用环节 | 映射到多Agent协作 |
|---|---|
| `brainstorming` → 意图澄清 | 收到指令先反问确认，避免直接执行 |
| `writing-plans` → 任务分解 | 拆解后分发云系/风系执行 |
| `verification-before-completion` → 交付检查 | 执行结果先验证再上报 |
| `finishing-a-branch` → 收尾归档 | 结果写入 Obsidian + 通知用户 |

---

## 六、整合路径

### 路径 A：直接移植（适合编码子任务）

Superpowers 可安装为 Claude Code 的插件（Skill 格式），但：
- **只有 Claude Code 会话可用**
- 不会自动扩散到其他 OpenClaw Agent

**安装命令（Claude Code）：**
```bash
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
```

**触发示例：**
| 对 Claude Code 说 | 激活技能 |
|---|---|
| "帮我规划这个功能" | `brainstorming` |
| "写个实现方案" | `writing-plans` |
| "开始执行" | `executing-plans` |
| "帮我 review 代码" | `requesting-code-review` |
| "修复这个 bug" | `systematic-debugging` |
| "功能写完了，帮我收尾" | `finishing-a-branch` |

### 路径 B：为团队定制「轻量版」方法论（推荐）

从 Superpowers 提取通用部分，转化为协作规范，应用于所有 Agent。

---

## 七、Superpowers 的安装与使用

### 7.1 支持平台

| 平台 | 安装方式 |
|---|---|
| Claude Code（官方市场） | `/plugin install superpowers@claude-plugins-official` |
| Claude Code（插件市场） | `/plugin marketplace add obra/superpowers-marketplace` |
| Cursor | `/add-plugin superpowers` |
| Codex | Fetch `https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md` |
| OpenCode | Fetch `https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md` |
| Gemini CLI | `gemini extensions install https://github.com/obra/superpowers` |

### 7.2 验证安装

启动新会话，问「帮我规划这个功能」或「帮我 debug」，Agent 应自动触发相关技能。

---

## 八、建议的第一步

**先选一个具体任务，用 Superpowers 方法论跑一遍演示：**

示例任务："检查所有服务器状态并出报告"

执行流程：
1. **意图澄清** — 汇总报告 vs 实时状态？报告格式？触发条件？
2. **形成文字计划** → 用户确认
3. **分发子任务** → 并行执行
4. **交叉验证** → 汇总交付

---

## 九、项目信息

- **作者：** Jesse Vincent (Best Practical)
- **许可证：** MIT
- **仓库：** https://github.com/obra/superpowers
- **市场：** https://github.com/obra/superpowers-marketplace
- **Discord：** https://discord.gg/Jd8Vphy9jq
- **博客：** https://blog.fsck.com/2025/10/09/superpowers/

---

## 十、待办事项

- [ ] 在 Claude Code 中安装 Superpowers（本次暂不执行）
- [ ] 选一个具体任务跑一遍演示
- [ ] 制定团队轻量版方法论文档
- [ ] 将方法论同步到 MEMORY.md

---

*本文档由星枢整理，基于 2026-04-05 与比利哥的讨论*