176 lines
5.7 KiB
Markdown
176 lines
5.7 KiB
Markdown
---
|
||
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 与比利哥的讨论*
|