Superpowers：为AI编程智能体提供标准软件开发工作流的技能框架

Superpowers 是由开发者 obra 开源的一款专为 AI 编程智能体（如 Claude Code、Cursor、Codex、Gemini 等）打造的底层技能框架与标准软件开发工作流工具。它基于成熟的软件工程方法论构建，旨在解决当前 AI 编程助手在面对复杂项目时容易偏离目标、缺乏规划和忽视测试等问题。Superpowers 为智能体预设了一套高度标准化的、可组合的“技能（Skills）”指令集。当开发者准备编写代码时，Superpowers 会引导 AI 首先进行需求分析与设计确认，随后将任务拆解为极细颗粒度的执行计划，并严格遵循红/绿测试驱动开发（TDD）、YAGNI（不写不需要的代码）和 DRY（不要重复自己）等原则进行自动化开发。通过引入“子智能体驱动开发（Subagent-driven-development）”模式，AI 能够自动在隔离的 Git 工作区内完成代码编写、自我审查和系统性调试。开发者只需进行高维度的决策和把关，AI 便能保持长时间的自主稳定运行，大幅提升软件开发的效率和代码交付质量。

功能列表

• 🧠 需求头脑风暴与苏格拉底式提问：在编写代码前自动激活。智能体会通过提问完善开发者粗略的想法，探索替代方案，并分段呈现设计文档以供审阅和保存。
• 🌳 Git 工作区完全隔离管理：设计方案获批后，自动基于新分支创建隔离的 Git 工作树（Worktrees），运行项目设置并建立干净的测试基线，杜绝污染主干代码。
• 📋 极细颗粒度任务拆解与执行计划：将复杂开发工作精确分解为 2 到 5 分钟即可完成的微型任务。每个任务强制包含确切的文件路径、完整的代码预期和具体的测试验证步骤。
• 🤖 子智能体驱动开发（Subagent-driven-development）：基于任务计划，系统会为每个小任务分配一个全新的子智能体。采用两阶段审查模式（先查验需求一致性，再查验代码规范），支持批量执行并允许设置人类干预节点。
• 🧪 强制执行测试驱动开发（TDD）：在编码阶段严格执行“红-绿-重构”循环。强制要求先编写会报错的测试代码，再编写仅能让测试通过的最简业务代码，并自动清理任何未被测试覆盖的超前代码。
• 🔍 系统性多层代码调试与审查：内置 4 阶段根本原因分析流程（包含深度防御、条件等待等高级技术）。在任务节点之间自动请求代码审查，严重问题将直接阻断开发进度以强制修复。
• 🌿 全自动分支闭环与清理：当所有任务清单执行完毕后，系统将自动重新运行全局测试，并向开发者提供后续操作选项（合并代码、提交 PR、保留或废弃该分支），最后自动清理临时工作区。

使用帮助

欢迎使用 Superpowers！这是一款能让你的 AI 编程助手真正具备“高级软件工程师”素养的底层技能框架。Superpowers 的使用逻辑并不是提供一个图形化界面，而是通过向你的 AI 编程环境（如 Claude Code、Cursor）注入一套强制性的底层运行法则。只有深入了解它的安装逻辑和运作流，才能发挥其 100% 的效率。以下是极为详细的操作与使用指南。

一、 核心安装流程（多平台支持）

Superpowers 支持主流的 AI 编程工具，安装过程根据你所使用的平台有所不同：

1. 在 Claude Code 中安装（推荐）
如果你使用的是官方的 Claude Code 命令行工具，可以通过内置的插件市场直接安装：

• 官方市场快速安装：在终端运行 /plugin install superpowers@claude-plugins-official。
• 第三方市场安装：如果官方市场未更新最新版，可先注册 obra 的专属市场：/plugin marketplace add obra/superpowers-marketplace，随后执行安装：/plugin install superpowers@superpowers-marketplace。

2. 在 Cursor 中安装
Cursor 同样拥有内置插件系统。

• 打开 Cursor 编辑器，唤出 Cursor Agent 对话框。
• 输入 /add-plugin superpowers。
• 或者直接在 Cursor 的插件市场中搜索“superpowers”并点击安装。

3. 在 Gemini CLI 中安装

• 在终端中运行扩展安装命令：gemini extensions install https://github.com/obra/superpowers
• 如需更新，运行：gemini extensions update superpowers

4. 在 Codex 或 OpenCode 中手动配置
对于这类纯文本或指令驱动的模型，你需要在对话的最初赋予它读取 Superpowers 规则的权限。

• Codex：在对话框输入 Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
• OpenCode：输入 Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

如何验证安装成功？
启动一个全新的会话，直接向 AI 输入：“Help me plan this feature”（帮我规划这个功能）或“Let’s debug this issue”（我们来调试这个问题）。如果 AI 没有立刻开始写代码，而是开始针对你的需求进行详细提问，说明 Superpowers 的 brainstorming（头脑风暴）技能已成功自动接管对话。

二、 标准化工作流实战操作指南

当你安装完成并对 AI 说出你的需求后（例如：“我要开发一个用户登录模块”），Superpowers 将强制 AI 按照以下 6 个标准阶段执行。请注意，在每个关键节点，AI 都会停下来等待你的指令（通常是说 “go” 或者 “yes”）。

阶段 1：需求头脑风暴（Brainstorming）

• 操作表现：AI 绝对不会直接输出代码。它会化身为一位产品经理，通过苏格拉底式的连续提问，挖掘你需求背后的真实目的。它可能会问：“用户密码需要什么级别的加密机制？”、“登录失败次数过多是否需要锁定限制？”
• 你的操作：耐心回答 AI 的问题。如果你对某些技术细节不确定，可以直接回复“你来建议一个最佳方案”。
• 结果确认：当 AI 收集到足够的信息后，它会分块展示一份系统设计文档。你需要阅读并回复“确认设计，继续”。

阶段 2：创建 Git 隔离工作区（Using Git Worktrees）

• 操作表现：设计获批后，AI 会自动调用命令行操作 Git。它不会在你当前的主分支（Main/Master）上直接开搞，而是自动创建一个全新的分支（例如 feature/user-login）以及一个隔离的 Git 工作目录。
• 你的操作：无需手动干预，静待 AI 在终端打印出“测试基线清理完成”的提示即可。这保证了哪怕代码写废了，随时可以一键丢弃，绝不会弄脏你的主项目。

阶段 3：撰写颗粒度执行计划（Writing Plans）

• 操作表现：AI 会根据设计文档，生成一份详尽的任务清单（Task List）。Superpowers 强制要求这些任务被拆解到“2到5分钟即可完成”的粒度。例如，它不会写“编写登录后端逻辑”，而是写“在 /src/auth/ 下创建 password_hash.test.ts 文件”。
• 你的操作：仔细审查这份计划书。这就像带新员工一样，计划书足够细致，执行才不会跑偏。如果没有问题，对 AI 说：“Go”（开始执行）。

阶段 4：子智能体并行开发与 TDD 测试驱动（Execution & TDD）

• 操作表现：此时是 Superpowers 的核心魔法时刻。系统会为任务列表中的每一项指派一个“独立的子智能体”来完成。
  • TDD 强制干预：智能体在写具体功能前，会被强制要求先写一个报错的测试用例（红灯）。
  • 随后，它会编写最精简的代码让测试跑通（绿灯）。
  • 如果有任何未经测试验证的多余代码，Superpowers 会自动将其删除。
• 你的操作：在这个阶段，你可以去喝杯咖啡。AI 能够自主工作几个小时。你可以在终端屏幕上看着它不断地建立文件、运行测试、报错、自我修复代码、测试通过并提交 Commit。

阶段 5：内部代码审查机制（Requesting Code Review）

• 操作表现：当几个相关联的小任务完成后，AI 会触发 requesting-code-review 技能。它会自我对比刚写好的代码与阶段 3 制定的计划是否一致。如果发现严重 Bug 或规范偏差，流程会被自动阻断。
• 你的操作：如果 AI 遇到无法自动修复的底层冲突，它会弹出提示询问你。此时你可以在对话框中指出修改意见，例如“这里的数据库调用请改用连接池模式”。AI 接收到反馈后（receiving-code-review），会继续进行修复。

阶段 6：分支闭环与交付（Finishing a Development Branch）

• 操作表现：所有任务清单打钩完毕，全部测试用例显示 100% Pass。AI 会向你做最终汇报。
• 你的操作：AI 会提供几个选项供你选择：
  1. 直接合并到主分支（Merge）
  2. 在 GitHub/GitLab 提交一个 Pull Request (PR)
  3. 暂时保留分支，后续再做决定
  4. 废弃当前代码
     选择合并后，Superpowers 会自动帮你清理之前的临时 Git 工作区，整个无缝、干净、标准的软件开发闭环到此结束。

三、 高级技巧与注意事项

• 跳过繁琐步骤：如果你在修复一个极小且明确的拼写错误，不想走头脑风暴流程，可以在提示词中明确下发强指令：“跳过 brainstorming 技能，直接修改 index.html 中的错别字并提交”。
• 自定义技能编写：如果你希望为你的团队加入特殊的代码规范检查。你可以基于仓库中的 writing-skills 技能模板，用 Markdown 文件编写自定义的工作流，并放入项目目录供 AI 读取。AI 会将你的自定义规范当做首要原则来执行。

通过这套严密的方法论，即使是缺乏项目经验的 AI 模型，也能被 Superpowers 调教成一位遵循标准规范、重视测试交付的“高级软件工程师”。请务必信任并遵循这套系统的工作流，它将极大消除 AI 生成代码的“幻觉”，带来工业级稳定性的代码输出。

应用场景

1. 独立开发者的复杂 MVP 快速构建
   当独立开发者需要从零构建包含前后端交互和数据库的 MVP 时，Superpowers 能够通过其自动任务拆解和子智能体驱动特性，将巨大的工作量化整为零，并自主连续工作数小时，帮助开发者快速完成项目原型的稳定交付。
2. 遗留旧系统的渐进式重构
   在面对庞大且缺乏文档的旧项目时，直接让 AI 修改代码极易引发连锁 Bug。Superpowers 强制推行的测试驱动开发（TDD）和隔离工作区（Git Worktrees）功能，使得 AI 必须在写重构代码前先建立测试基线，确保在不破坏原有功能逻辑的前提下进行安全重构。
3. 复杂业务逻辑的系统性排错调试
   当出现难以复现的深层 Bug 时，常规 AI 助手通常只会靠“猜”来修改代码。借助 Superpowers 内置的 4 阶段根本原因系统性调试（Systematic Debugging）技能，AI 能够通过条件追踪和日志验证等硬核排错手段，科学且严谨地定位并修复深层逻辑问题。
4. 团队标准化代码规范的强制执行
   在由多人（或人机协作）参与的开发团队中，保证代码风格和质量一致性是难点。通过配置 Superpowers，所有经由 AI 生成的代码都必须通过预设的代码审查机制，强制执行 YAGNI（不写无用代码）和 DRY（不重复代码）原则，大幅降低代码审核员的工作负担。

QA

1. 什么是 Superpowers？
   Superpowers 是一个开源的 AI 编程智能体技能框架和开发方法论工具。它不是独立的编辑器，而是作为插件或核心指令集安装在 Claude Code、Cursor 等平台上，为 AI 强制加上头脑风暴、任务拆解、隔离开发和测试驱动（TDD）等标准软件工程规范。
2. Superpowers 支持哪些 AI 编程环境？
   目前 Superpowers 全面支持 Claude Code（通过官方插件市场）、Cursor（通过内置插件市场）、Gemini CLI，同时也支持以纯指令形式注入到 Codex 和 OpenCode 等大语言模型工作流中。
3. 在工作过程中如果 AI 偏离了计划怎么办？
   由于 Superpowers 强制将工作拆解为 2 到 5 分钟的微型任务并进行阶段性审查，一旦发现偏差，系统内部的代码审查机制会自动拦截并阻断开发进度。若遇到特殊情况，开发者也可以在 AI 执行每个微任务之间的人类检查点（Checkpoint）通过文字指令进行手动干预纠偏。
4. 如何更新我已经安装的 Superpowers？
   如果你使用的是 Claude Code，可以在终端中运行 /plugin update superpowers 来保持技能库的最新状态。Gemini 用户可运行 gemini extensions update superpowers。插件更新后，内置的技能树逻辑会自动升级。
5. 它真的可以在我离开电脑时自己写几个小时代码吗？
   是的。只要你在前期的“需求头脑风暴”阶段与 AI 充分确认了设计方案，并在“执行计划”阶段审核通过了它拆解的任务列表，当你输入 “go” 后，采用“子智能体驱动开发”的 AI 就能在隔离分支中自动循环执行编码、测试、纠错流程，实现数小时的自主工作。