文章目录
- [Superpowers 实战指南：用"方法论"驯服 AI 编程](#Superpowers 实战指南：用“方法论”驯服 AI 编程)
Superpowers 实战指南：用"方法论"驯服 AI 编程
前言
在 AI 辅助编程中，我们常遇到 AI 盲目生成代码、缺乏全局规划、遇到 Bug 只会"头痛医头"等问题。Superpowers 并非传统的代码库或文档管理工具，而是一套方法论驱动的 AI 编程工作流框架。它通过内置的"技能（Skills）"系统，将资深工程师的开发经验（如 TDD、系统化调试、代码审查）固化为标准流程，强制 AI 遵循最佳实践，从而大幅提升代码质量和开发效率。
以下是 Superpowers 的完整上手与实战教程。
第一步：环境准备与安装配置
Superpowers 完美适配 Claude Code、OpenCode、Codex 等主流 AI 编程助手。以下以最常用的 Claude Code 和 OpenCode 为例：
1. Claude Code 用户（极简安装）
在 Claude Code 终端中依次执行以下两条命令：
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace安装完成后，运行 /help，若能看到 brainstorm、write-plan 等命令，即表示安装成功。
2. OpenCode 用户（手动配置）
- • 克隆仓库 ：
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers - • 注册插件 ：
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js - • 链接技能 ：
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers - • 重启 OpenCode 即可生效。
第二步：掌握核心"技能"与工作流
Superpowers 的核心在于其 14+ 个内置技能。对于日常开发，掌握以下三大核心技能即可覆盖 80% 的场景：
1. brainstorming（头脑风暴：需求分析必备）
- • 触发命令 ：
/brainstorm或/superpowers:brainstorm - • 适用场景：开发新功能、重构模块前的需求澄清。
- • 核心机制 ：AI 会采用"苏格拉底式问答"，一次只问一个问题，帮你理清目的、约束和成功标准。随后提供 2-3 种方案并附带优缺点分析，最终生成结构化的设计文档。在未经你批准前，AI 绝不会提前写一行代码。
2. writing-plans & executing-plans（计划与执行）
- • 触发命令 ：
/write-plan与/execute-plan - • 适用场景：拿到明确需求后，触碰代码之前。
- • 核心机制：AI 会将复杂任务拆解为带有复选框的独立小任务（假设执行者对代码库一无所知）。确认后，AI 会按计划逐步推进，甚至自动分发给多个"子代理（Sub-Agents）"并行处理，大幅提升大型任务的执行效率。
3. systematic-debugging（系统化调试：Bug 修复利器）
- • 触发命令 ：
/debug或/systematic-debugging - • 适用场景：遇到报错、测试失败或意外行为时。
- • 核心机制：拒绝盲目试错。AI 会严格执行四步法：复现问题（写测试用例） → 追踪调用链定位根因 → 修复根因（而非包一层 try-catch） → 跑测试验证修复且无新问题引入。
第三步：高阶实战------完整工作流串联
Superpowers 的真正威力在于将上述技能串联，形成标准化的工程流水线。当你需要开发一个完整功能时，建议按以下流程操作：
- \1. 需求探索 ：输入
/superpowers:brainstorm，与 AI 充分沟通，理清边界。 - \2. 生成计划 ：输入
/superpowers:write-plan，让 AI 输出详细的实施步骤。 - \3. 人工审阅：仔细检查计划，修改不合理之处后确认（AI 会严格等待你的指令）。
- \4. 自动执行 ：输入
/superpowers:execute-plan。AI 将自动分发任务，遵循 TDD（测试驱动开发）流程，并在任务间自动进行 Code Review。 - \5. 最终验证 ：AI 会在完成前自动运行
verification-before-completion技能，确保所有测试通过，并发起最终的代码审查。
进阶技巧与避坑指南
- • 配合 Git Worktrees 隔离开发 ：在开发复杂功能时，主动要求 AI 使用
using-git-worktrees技能。它会为每个子代理创建独立的工作区，避免文件冲突，实现安全试错。 - • 避免"杀鸡用牛刀"：Superpowers 的完整流程适合 50 行以上的功能开发或复杂 Bug 修复。如果是改一行 CSS 或修复一个错别字，直接用自然语言让 AI 修改即可，无需走完整流程。
- • 强制高质量输出：如果你希望 AI 严格按工程标准执行，可以在需求前加上一句："按 Superpowers 完整流程，先 brainstorm，再 write-plan，最后 execute-plan，必须做 TDD 和 code review"。
通过 Superpowers，你不再是给 AI 下达零散指令的"监工"，而是拥有一套成熟软件工程体系的"架构师"。它用流程约束了 AI 容易犯的错误，让 AI 产出的代码质量无限逼近有经验的工程师。