Superpowers 详细用法教程

项目地址：https://github.com/obra/superpowers
作者：Jesse Vincent (obra)
适用平台：主要为 Claude Code（Claude 的编码环境），也支持 Codex、OpenCode 等编码代理工具。
核心理念：这是一个“代理技能框架”（agentic skills framework），通过一系列可组合的“技能”（skills）强制 AI 编码代理遵循严格、可靠的软件开发方法论，而不是随意写代码。强调 TDD（测试驱动开发）、系统化调试、详细规划、子代理协作等，避免 AI 的常见问题（如跳过测试、过度复杂化）。

这个项目不是一个简单的系统提示词，而是一个插件化的技能系统。每个技能都是一个 Markdown 文件（SKILL.md），定义了特定场景下的严格规则。AI 在处理任务时必须先检查并调用相关技能。

适合所有开发者：无论你是初学者还是资深工程师，这个框架能让你的 AI 编码助手输出更可靠、生产级的代码。使用后，AI 不会直接冲上去写代码，而是先 brainstorm → plan → TDD 实施。

1. 打开 Claude Code。
2. 输入命令注册市场：

3. 安装 Superpowers 插件：

4. 重启 Claude Code（或新开会话）让插件生效。
5. 验证安装：

   你应该看到新命令，如：

   • claude code 教程 – 交互式设计精炼
   • – 创建实施计划
   • – 批量执行计划

更新插件：

技能会自动更新。

• 对于 Codex：
  在会话中告诉 AI：

  
  

• 对于 OpenCode：

详细文档在仓库的 目录。

• 技能发现与调用：AI 在收到任何任务时，必须先检查是否有相关技能适用（即使只有 1% 可能）。使用 工具加载技能文件，然后严格遵循。
• 强制性：技能不是建议，而是必须遵守的规则。违反规则（如先写代码再写测试）会被视为错误。
• 核心规则（来自 技能）：
  • 在任何响应前，先调用相关技能。
  • 如果技能有 checklist，就逐项创建 todo。
  • 多技能时优先级：过程技能（如 brainstorming） > 实现技能。

典型开发流程（AI 会自动触发）：

1. Brainstorming：AI 先理解需求，通过一问一答精炼设计，探索多种方案，分段呈现设计供你确认。最终保存到 。
2. 创建工作空间：使用 git worktrees 创建隔离分支，避免污染主分支。
3. Writing Plans：把设计拆成极小的任务（每个 2-5 分钟），每个任务包含精确文件路径、完整代码、测试命令、预期输出。
4. 执行计划：
   • 子代理驱动（subagent-driven-development）：主 AI 派发子代理逐任务实施 + 双阶段审查。
   • 或批量执行（executing-plans）：在独立会话中批量跑，定期检查点。
5. TDD 强制：每个实现都必须 Red → Green → Refactor，且必须看到测试先失败。
6. 代码审查：任务间自动请求审查。
7. 完成分支：测试全通过后，提供合并/PR/丢弃选项。

AI 会自动检查技能，并在合适时机触发。

仓库有 14 个核心技能（在 目录）。每个技能都是一个 SKILL.md 文件。下面挑选几个最重要的，完整贴出内容（作为“提示词实例”），让你明白技能的严格性。

这是第一个技能，建立整个框架规则。

完整内容：

（内容很长，核心是：任何任务前先调用技能，拒绝“简单问题就不用”的借口。）

触发时机：任何创意工作前（新功能、修改行为）。

完整内容示例（节选关键部分）：

使用实例：
你说：“帮我建一个 Todo List app”。
AI 会先调用 brainstorming：

• 先问：“这是 Web app 还是命令行？用什么技术栈？”
• 提出 3 种方案（React + Flask、纯 Flask、Next.js 等）。
• 分段呈现设计，你确认后保存文档。

触发时机：任何实现或 bugfix 前。

完整内容示例（包含代码实例）：

代码实例（来自技能文档）：

为什么这么严格：防止 AI 写“看起来对”的代码而不验证。

触发时机：设计确认后。

完整内容示例：

计划文档实例（AI 会生成类似）：

Step 2: Run test… (包含命令和预期)
…

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

/plugin update superpowers

我想用 Python 写一个命令行 Todo List 应用，支持 add、list、done、delete 命令，用 JSON 文件存数据。

设计看起来不错，继续吧。

设计批准了，请生成实施计划。

计划看起来好，去执行吧。

用 subagent-driven-development 执行计划，让它自主工作。

我的代码在添加任务时偶尔崩溃，帮我调试。下面是代码： [贴代码]

/superpowers:brainstorm 先分析可能的根因。

这个功能写完了，请做代码审查。

这个项目有前端和后端，可以并行开发吗？

全部搞定，准备合并。

快速写一个 Python 函数反转字符串。

告诉我怎么用 superpowers 系统。