Superpowers 完整指南

官方仓库: obra/superpowers 作者: Jesse Vincent (Prime Radiant)

📝 前言

Superpowers 是一个为 AI 编码代理 设计的完整软件开发工作流框架。它不是简单的命令集合，而是一套完整的开发方法论。当用户启动编码代理时，它不会立即跳入写代码，而是先退后一步、询问用户真正想要实现什么，通过 Socratic 方式完善需求，再分块展示给用户确认，最后生成详细计划并自主执行。

二、核心哲学

Superpowers 遵循四大核心理念：

1. Test-Driven Development (TDD)

1	RED → GREEN → REFACTOR

始终先写测试，再写实现代码，最后重构。

2. Systematic over Ad-hoc

"流程优于猜测"

使用系统化的调试和问题解决方法，而不是碰运气。

3. Complexity Reduction

"简洁性是首要目标"

YAGNI (You Aren't Gonna Need It) 和 DRY (Don't Repeat Yourself) 原则。

4. Evidence over Claims

"验证后再宣布成功"

在声称问题解决前，必须有实际证据证明。

三、技能体系

Superpowers 包含多个可组合的技能模块：

需求与规划

技能	功能
`brainstorming`	Socratic 设计优化，通过提问完善想法
`writing-plans`	制定详细实施计划，分解为 2-5 分钟的任务
`writing-skills`	创建新技能

开发执行

技能	功能
`test-driven-development`	RED-GREEN-REFACTOR 循环
`executing-plans`	批量执行与检查点
`dispatching-parallel-agents`	并发子代理工作流
`subagent-driven-development`	双阶段审查（规范合规性 + 代码质量）

调试与验证

技能	功能
`systematic-debugging`	4 阶段根因分析
`verification-before-completion`	确保问题真正修复

协作与审查

技能	功能
`requesting-code-review`	预审查清单
`receiving-code-review`	响应审查反馈
`finishing-a-development-branch`	合并/PR 决策

版本控制

技能	功能
`using-git-worktrees`	管理并行开发分支
`using-superpowers`	介绍技能系统（入门技能）

四、安装配置

支持的 IDE/工具

平台	安装方法
Claude Code	`/plugin install superpowers@claude-plugins-official`
Claude Code (Alt)	`/plugin marketplace add obra/superpowers-marketplace` then `/plugin install superpowers@superpowers-marketplace`
Cursor	`/add-plugin superpowers` 或插件市场搜索
Codex	`Fetch instructions from .codex/INSTALL.md`
OpenCode	`Fetch instructions from .opencode/INSTALL.md`
Gemini CLI	`gemini extensions install https://github.com/obra/superpowers`

详细安装步骤

Claude Code (官方市场)

# 方法一：直接安装
/plugin install superpowers@claude-plugins-official

# 方法二：通过插件市场
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Codex

1	告知 Codex: "Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md"

Gemini CLI

# 安装
gemini extensions install https://github.com/obra/superpowers

# 更新
gemini extensions update superpowers

验证安装

安装成功后，可以尝试： - "帮我计划这个功能" - "调试这个问题"

代理应该自动调用相关技能。

五、工作流程 (7 阶段)

┌─────────────────────────────────────────────────────────────────┐
│                      Superpowers 工作流                          │
└─────────────────────────────────────────────────────────────────┘

     ┌──────────────┐
     │  brainstorming │ ← 先问清楚要做什么
     └──────┬───────┘
            ↓
     ┌──────────────┐
     │using-git-    │ ← 创建隔离工作空间
     │worktrees     │
     └──────┬───────┘
            ↓
     ┌──────────────┐
     │ writing-plans │ ← 生成详细计划
     └──────┬───────┘
            ↓
     ┌──────────────┐
     │ subagent-     │ ← 子代理执行
     │ driven-       │
     │ development   │
     └──────┬───────┘
            ↓
     ┌──────────────┐
     │ test-driven  │ ← TDD 循环
     │ development  │
     └──────┬───────┘
            ↓
     ┌──────────────┐
     │ requesting-  │ ← 代码审查
     │ code-review  │
     └──────┬───────┘
            ↓
     ┌──────────────┐
     │ finishing-a- │ ← 合并或创建 PR
     │ development- │
     │ branch       │
     └──────────────┘

阶段详解

阶段 1: brainstorming (设计优化)

触发: 写代码前
方式: 通过提问完善想法
产出: 设计文档

阶段 2: using-git-worktrees (版本控制)

触发: 设计批准后
方式: 创建隔离工作空间
产出: 独立分支

阶段 3: writing-plans (计划制定)

触发: 获批设计后
方式: 分解为 2-5 分钟的任务
产出: 详细实施计划

阶段 4: subagent-driven-development (执行开发)

触发: 有计划时
方式: 分派子代理执行任务
产出: 代码实现

阶段 5: test-driven-development (测试驱动)

触发: 实现过程中
方式: RED → GREEN → REFACTOR
产出: 测试通过

阶段 6: requesting-code-review (代码审查)

触发: 任务之间
方式: 预审查清单
产出: 审查反馈

阶段 7: finishing-a-development-branch (完成开发)

触发: 任务完成时
方式: 验证测试 + 合并决策
产出: PR 或合并

六、使用示例

示例 1: 新功能开发

1 2	# 用户请求 "我想要一个用户认证系统，支持 GitHub 和 Google 登录"

代理响应流程: 1. 激活 brainstorming → 询问详细需求 2. 确认后激活 using-git-worktrees → 创建分支 3. 激活 writing-plans → 生成计划 4. 激活 subagent-driven-development → 开始开发

示例 2: Bug 调试

1 2	# 用户请求 "用户登录后 session 会随机失效"

代理响应流程: 1. 激活 systematic-debugging → 4 阶段分析 2. 定位问题后激活 verification-before-completion → 验证修复

示例 3: 代码审查

1 2	# 用户请求 "审查一下这个 PR"

代理响应流程: 1. 激活 requesting-code-review → 预审查清单 2. 检查后激活 receiving-code-review → 响应反馈

七、与类似框架对比

特性	Superpowers	Claude Code	Codex
工作流框架	✅ 完整	⚪ 基础	⚪ 基础
TDD 内置	✅	❌	❌
Subagent 支持	✅	⚪	⚪
系统化调试	✅	❌	❌
技能系统	✅ 可组合	⚪ 基础	⚪

八、相关资源

官方文档
Prime Radiant - 团队官网
Discord 社区 - 获取支持

九、结语

Superpowers 为 AI 编码代理带来了系统化的开发方法论，通过 7 阶段的结构化工作流，确保 AI 在开始编码前先理解需求、在编码后验证结果。对于追求高质量代码的团队，这是一个值得采用的工作框架。

小贴士: Superpowers 最适合复杂的多步骤项目。对于简单任务，直接使用 Claude Code 的原生功能可能更高效。

Happy Systematic Coding! 🔧🚀