Superpowers 实战指南：用“方法论”驯服 AI 编程

文章目录

• [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. \1. 需求探索 ：输入 /superpowers:brainstorm，与 AI 充分沟通，理清边界。
2. \2. 生成计划 ：输入 /superpowers:write-plan，让 AI 输出详细的实施步骤。
3. \3. 人工审阅：仔细检查计划，修改不合理之处后确认（AI 会严格等待你的指令）。
4. \4. 自动执行 ：输入 /superpowers:execute-plan。AI 将自动分发任务，遵循 TDD（测试驱动开发）流程，并在任务间自动进行 Code Review。
5. \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 产出的代码质量无限逼近有经验的工程师。