# Superpowers使用笔记

Superpowers是一个为AI编程智能体（Agent）设计的高标准工程流水线。它不是一个简单的工具，而是一套约束和技能库，强制AI像顶级资深软件架构师一样思考和工作，而不是拿到需求就直接“无脑”写代码。

简单说，Superpowers就是让AI写代码时更靠谱、更有条理的一套软件编程方法论。它给Claude Code / Codex这类AI编程工具加上一套固定的做事步骤，避免AI想到哪写到哪。

你可以把它理解为：
- 给AI请了个好主管：先搞清楚要干嘛，再让AI动手。
- 给项目画张路线图：先写计划，在写代码。
- 给代码做个体检：先写测试，再实现功能。

GitHub地址：https://github.com/obra/superpowers

## 安装

Claude Code 可通过官方插件直接安装：
```
/plugin install superpowers@claude-plugins-official
```

或者先添加Superpowers插件市场，然后再安装：
```
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
```

Codex APP安装也是可以通过它的官方插件市场来安装：
- In the Codex app, click on Plugins in the sidebar.
- You should see `Superpowers` in the Coding section.
- Click the `+` next to Superpowers and follow the prompts.

其他工具的安装方法可参考Superpowers的官方文档说明。

## 技能列表
安装后会自动安装多个SKILL

**Testing**
- **test-driven-development** - RED-GREEN-REFACTOR cycle (includes testing anti-patterns reference)

**Debugging**
- **systematic-debugging** - 4-phase root cause process (includes root-cause-tracing, defense-in-depth, condition-based-waiting techniques)
- **verification-before-completion** - Ensure it's actually fixed

**Collaboration**
- **brainstorming** - Socratic design refinement
- **writing-plans** - Detailed implementation plans
- **executing-plans** - Batch execution with checkpoints
- **dispatching-parallel-agents** - Concurrent subagent workflows
- **requesting-code-review** - Pre-review checklist
- **receiving-code-review** - Responding to feedback
- **using-git-worktrees** - Parallel development branches
- **finishing-a-development-branch** - Merge/PR decision workflow
- **subagent-driven-development** - Fast iteration with two-stage review (spec compliance, then code quality)

**Meta**
- **writing-skills** - Create new skills following best practices (includes testing methodology)
- **using-superpowers** - Introduction to the skills system

## 三个核心步骤
刚开始的时候不需要整个都用上，把下面三个技能先用上，后面深度集成后再慢慢扩展。

第一步：**brainstorm**——先搞明白要做什么
```
/superpowers:brainstorm
```
他会帮你：
- 一步步问清楚：你到底想做啥功能
- 用简单问题确认：目标、限制条件、怎么算成功
- 给出2-3种实现思路，让你选个自己觉得合适的
特别适合这种情况：
- 我想做个功能，但是说清楚具体要啥
- 这东西该做成按钮、页面还是接口？

第二步：**writing-plans**——写个谁都能看得懂的计划
```
/superpowers:writing-plans
```
计划一般会有这些：
- 哪些文件要改，哪些文件要新增
- 每一步具体干啥
- 每一步怎么验证：跑什么命令、看到什么结果
这样做的好处：
- 每个小步骤2-5分钟就能搞定
- 任何开发者看着计划都能跟着做

第三步：**executing-plans**——按计划一步步实现
```
/superpowers:executing-plans
```

## 中文版本superpowers-zh

对于国内开发者，还可以试试中文版本的：https://github.com/jnMetaCode/superpowers-zh

安装方法
```
npx superpowers-zh --global                 # 自动检测已装工具
npx superpowers-zh --global --tool claude   # 或指定工具
```

|Skill|用途|
|---|---|
|**头脑风暴** (brainstorming)|需求分析 → 设计规格，不写代码先想清楚|
|**编写计划** (writing-plans)|把规格拆成可执行的实施步骤|
|**执行计划** (executing-plans)|按计划逐步实施，每步验证|
|**测试驱动开发** (test-driven-development)|严格 TDD：先写测试，再写代码|
|**系统化调试** (systematic-debugging)|四阶段调试法：定位→分析→假设→修复|
|**请求代码审查** (requesting-code-review)|派遣审查 agent 检查代码质量|
|**接收代码审查** (receiving-code-review)|技术严谨地处理审查反馈，拒绝敷衍|
|**完成前验证** (verification-before-completion)|证据先行——声称完成前必须跑验证|
|**派遣并行 Agent** (dispatching-parallel-agents)|多任务并发执行|
|**子 Agent 驱动开发** (subagent-driven-development)|每个任务一个 agent，两轮审查|
|**Git Worktree 使用** (using-git-worktrees)|隔离式特性开发|
|**完成开发分支** (finishing-a-development-branch)|合并/PR/保留/丢弃四选一|
|**编写 Skills** (writing-skills)|创建新 skill 的方法论|
|**使用 Superpowers** (using-superpowers)|元技能：如何调用和优先使用 skills|
新增了🇨🇳 中国特色 Skills（6 个）

| Skill                                   | 用途                            | 调用方式                              |
| --------------------------------------- | ----------------------------- | --------------------------------- |
| **中文代码审查** (chinese-code-review)        | 符合国内团队文化的代码审查规范               | `/chinese-code-review`（手动）        |
| **中文 Git 工作流** (chinese-git-workflow)   | 适配 Gitee/Coding/极狐 GitLab/CNB | `/chinese-git-workflow`（手动）       |
| **中文技术文档** (chinese-documentation)      | 中文排版规范、中英混排、告别机翻味             | `/chinese-documentation`（手动）      |
| **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范     | `/chinese-commit-conventions`（手动） |
| **MCP 服务器构建** (mcp-builder)             | 构建生产级 MCP 工具，扩展 AI 能力边界       | 自动                                |
| **工作流执行器** (workflow-runner)            | 在 AI 工具内运行多角色 YAML 工作流        | 自动                                |


---

> 作者: XiongNeng  
> URL: https://xiongneng.me/posts/ai/superpowers/