Superpowers

Superpowers 不是一个简单的插件，而是一套完整的软件开发工作流程，专为 AI 编码智能体设计。它通过一组可组合的“技能”（Skills）和初始指令，确保你的智能体不仅能写代码，还能像经验丰富的工程师一样思考、规划与协作。

这套系统最初为 Claude Code 构建，但同样适用于 Codex 和 OpenCode。它的核心理念很明确：不要让 AI 直接写代码，而是先理解问题、设计方案、制定计划，再分步执行。

工作原理：从需求到交付的完整闭环

当你启动一个编码任务时，搭载 Superpowers 的智能体不会立刻跳进实现细节。它会先退一步，主动询问你真正想解决什么问题。

在对话中厘清需求后，它会将设计拆解成简短、清晰的片段呈现给你确认。一旦你认可方案，它会生成一份足够详细的实施计划——详细到能让一个缺乏判断力但执行力强的初级工程师也能照做无误。

这份计划严格遵循工程最佳实践：

• 真正的测试驱动开发（TDD）：先写失败测试，再写最小实现；
• YAGNI 原则（You Aren’t Gonna Need It）：不提前实现未明确需求的功能；
• DRY 原则（Don’t Repeat Yourself）：避免重复逻辑。

确认“开始”后，系统进入 子智能体驱动开发（Subagent-Driven Development）阶段：每个任务由独立的子智能体完成，经过两轮评审（先看是否符合规格，再看代码质量），并持续推进，全程可自主运行数小时而不偏离轨道。

最关键的是：所有技能自动触发，无需手动干预。你的智能体“天生”就拥有这些能力。

支持平台与安装方式

Superpowers 可在多个 AI 编码平台使用，安装方式略有不同：

▶ Claude Code（推荐方式）

通过插件市场一键安装：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

验证是否成功：

/help

应能看到 /superpowers:brainstorm、/superpowers:write-plan、/superpowers:execute-plan 等命令。

更新插件：

/plugin update superpowers

▶ OpenCode

执行以下指令自动安装：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

或手动克隆并创建符号链接（详见官方 INSTALL.md）。

▶ Codex

类似地，运行：

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

核心工作流程：强制执行，非可选建议

Superpowers 的工作流是强制性的，不是可有可无的辅助功能。智能体会在合适时机自动激活对应技能：

• brainstorming：在写代码前，通过提问细化模糊需求，探索替代方案，输出可确认的设计文档。
• using-git-worktrees：在新分支创建隔离工作区，确保测试基线干净。
• writing-plans：将任务拆解为 2–5 分钟可完成的小单元，明确文件路径、完整代码和验证步骤。
• subagent-driven-development / executing-plans：派遣子智能体逐项执行，带人工检查点或全自动推进。
• test-driven-development：严格执行 RED → GREEN → REFACTOR 循环，禁止在测试前写实现代码。
• requesting-code-review：每完成一个任务，自动对照方案评审，严重问题会阻断进度。
• finishing-a-development-branch：任务完成后，验证测试结果，提供合并、PR、保留或丢弃选项，并清理工作树。

内置技能库：覆盖开发全周期

Superpowers 提供四大类技能，全部开箱即用：

🔧 测试

• test-driven-development：完整 TDD 循环，含常见测试反模式参考。

🐞 调试

• systematic-debugging：四阶段根因分析法，支持条件等待与纵深防御策略。
• verification-before-completion：确保修复真实有效，而非表面掩盖。

👥 协作

• brainstorming：苏格拉底式追问，引导需求澄清；
• writing-plans / executing-plans：从规划到执行的无缝衔接；
• dispatching-parallel-agents：支持并发子智能体处理独立任务；
• using-git-worktrees / finishing-a-development-branch：Git 分支管理自动化；
• requesting-code-review / receiving-code-review：结构化评审与反馈响应。

🧠 元技能

• writing-skills：教你如何按规范创建新技能，并附带测试方法；
• using-superpowers：技能系统入门指南。

技能优先级与扩展机制

Superpowers 支持三层技能覆盖机制，优先级从高到低：

1. 项目技能（.opencode/skills/）
2. 个人技能（~/.config/opencode/skills/）
3. 内置技能（来自 Superpowers 仓库）

命名规则：

• skill-name → 自动按优先级查找；
• project:skill-name → 强制使用项目技能；
• superpowers:skill-name → 强制使用内置技能。

你可以轻松扩展或覆盖任一技能，实现高度定制化的工作流。

设计理念：工程思维优先

Superpowers 的底层哲学非常务实：

• 测试先行：没有测试的代码等于不存在；
• 系统化胜过临时发挥：用流程代替直觉；
• 简洁至上：复杂是 bug 的温床；
• 证据说话：成功必须通过验证，而非断言。

这套系统不是为了炫技，而是为了让 AI 成为你真正可靠的开发搭档——一个懂规范、守纪律、能协作的“数字工程师”。