Superpowers使用笔记

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

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

你可以把它理解为：

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

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

安装

Claude Code 可通过官方插件直接安装：

1

/plugin install superpowers@claude-plugins-official

或者先添加Superpowers插件市场，然后再安装：

1
2

/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——先搞明白要做什么

1

/superpowers:brainstorm

他会帮你：

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

第二步：writing-plans——写个谁都能看得懂的计划

1

/superpowers:writing-plans

计划一般会有这些：

• 哪些文件要改，哪些文件要新增
• 每一步具体干啥
• 每一步怎么验证：跑什么命令、看到什么结果 这样做的好处：
• 每个小步骤2-5分钟就能搞定
• 任何开发者看着计划都能跟着做

第三步：executing-plans——按计划一步步实现

1

/superpowers:executing-plans

中文版本superpowers-zh

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

安装方法

1
2

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