superpowers

Superpowers

Superpowers 是一套完整的软件开发方法论，专为你的编码智能体（coding agent）打造。它基于一组可组合的技能（skills）和一些初始指令构建，确保你的智能体能正确使用这些技能。

工作原理

从你启动编码智能体的那一刻起，它就开始了。当它发现你在构建某个东西时，它不会直接跳进写代码的环节。相反，它会后退一步，询问你真正想要做什么。

一旦它从对话中梳理出规格说明（spec），它会将规格切成足够短的段落展示给你，让你真正能阅读和消化。

在你确认设计后，智能体会整理出一份实施计划。这份计划清晰到让一个热情但品味不佳、缺乏判断力、没有项目上下文、且厌恶测试的初级工程师都能照着执行。它强调真正的红/绿 TDD（测试驱动开发）、YAGNI（你不会用到它）和 DRY（不要重复自己）。

接下来，一旦你说“开始”，它会启动一个**子智能体驱动开发（subagent-driven-development）**流程，让智能体逐个处理每个工程任务，检查并审查它们的工作，然后继续推进。Claude 能每次自主工作几个小时而不偏离你制定的计划，这并不罕见。

系统远不止这些，但上述部分是核心。而且因为技能会自动触发，你不需要做任何额外操作。你的编码智能体只是拥有了 Superpowers。

赞助

如果 Superpowers 帮你赚到了钱，并且你愿意的话，我将非常感谢你考虑赞助我的开源工作。

谢谢！

• Jesse

安装

注意： 安装方式因平台而异。

Claude Code 官方市场

Superpowers 可通过官方 Claude 插件市场获取。

从 Anthropic 的官方市场安装插件：

/plugin install superpowers@claude-plugins-official

Claude Code（Superpowers 市场）

Superpowers 市场为 Claude Code 提供 Superpowers 及其他一些相关插件。

在 Claude Code 中，先注册市场：

/plugin marketplace add obra/superpowers-marketplace

然后从该市场安装插件：

/plugin install superpowers@superpowers-marketplace

OpenAI Codex CLI

• 打开插件搜索界面

/plugins

搜索 Superpowers

superpowers

选择 Install Plugin

OpenAI Codex App

• 在 Codex 应用中，点击侧边栏的 Plugins。
• 你应该会在 Coding 栏目中看到 Superpowers。
• 点击 Superpowers 旁的 + 并按照提示操作。

Cursor（通过插件市场）

在 Cursor Agent 聊天中，从市场安装：

/add-plugin superpowers

或在插件市场中搜索 "superpowers"。

OpenCode

告诉 OpenCode：

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

详细文档： docs/README.opencode.md

GitHub Copilot CLI

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

Gemini CLI

gemini extensions install https://github.com/obra/superpowers

要更新：

gemini extensions update superpowers

基本工作流程

1. brainstorming（头脑风暴） - 在写代码之前激活。通过提问来完善粗略想法，探索替代方案，分块展示设计以供验证。保存设计文档。

2. using-git-worktrees（使用 Git 工作树） - 在设计批准后激活。在新分支上创建隔离的工作空间，运行项目设置，验证干净的测试基线。

3. writing-plans（编写计划） - 在设计批准后激活。将工作分解为小任务（每个 2-5 分钟）。每个任务包含确切文件路径、完整代码、验证步骤。

4. subagent-driven-development（子智能体驱动开发） 或 executing-plans（执行计划） - 在计划生成后激活。为每个任务分配全新的子智能体，并执行两阶段审查（规格合规性审查、代码质量审查），或按批次执行并设置人工检查点。

5. test-driven-development（测试驱动开发） - 在实现过程中激活。强制实施 RED-GREEN-REFACTOR 循环：编写失败测试，观察它失败，编写最少代码，观察它通过，提交。删除在测试之前编写的代码。

6. requesting-code-review（请求代码审查） - 在任务之间激活。对照计划进行审查，按严重程度报告问题。严重问题会阻止进度。

7. finishing-a-development-branch（完成开发分支） - 在所有任务完成后激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作树。

在任何任务之前，智能体会检查相关技能。 这些都是强制性工作流程，而非建议。

内部组件

技能库

测试

• test-driven-development（测试驱动开发） - RED-GREEN-REFACTOR 循环（包含测试反模式参考）

调试

• systematic-debugging（系统化调试） - 4 阶段根因排查流程（包含根因追踪、纵深防御、基于条件的等待等技巧）
• verification-before-completion（完成前验证） - 确保问题真正修复

协作

• brainstorming（头脑风暴） - 苏格拉底式设计精炼
• writing-plans（编写计划） - 详细的实施计划
• executing-plans（执行计划） - 带检查点的批量执行
• dispatching-parallel-agents（调度并行智能体） - 并发子智能体工作流
• requesting-code-review（请求代码审查） - 预审查清单
• receiving-code-review（接收代码审查） - 回应反馈
• using-git-worktrees（使用 Git 工作树） - 并行开发分支
• finishing-a-development-branch（完成开发分支） - 合并/PR 决策工作流
• subagent-driven-development（子智能体驱动开发） - 快速迭代，带两阶段审查（规格合规性、代码质量）

元技能

• writing-skills（编写技能） - 遵循最佳实践创建新技能（包含测试方法）
• using-superpowers（使用 Superpowers） - 技能系统简介

哲学

• 测试驱动开发 - 始终先写测试
• 系统化优于临时发挥 - 流程胜于猜测
• 降低复杂度 - 以简单为首要目标
• 证据优于断言 - 在宣布成功之前先验证

阅读最初的发布公告。

贡献

Superpowers 的一般贡献流程如下。请注意，我们通常不接受新技能的贡献，并且对技能的任何更新都必须在所有支持的编码智能体上正常工作。

1. Fork 该仓库
2. 切换到 'dev' 分支
3. 为你的工作创建一个分支
4. 遵循 writing-skills 技能来创建和测试新技能或修改后的技能
5. 提交一个 PR，并确保填写好 PR 模板。

完整指南请参见 skills/writing-skills/SKILL.md。

更新

Superpowers 的更新方式因编码智能体而异，但通常是自动的。

许可证

MIT 许可证 - 详情见 LICENSE 文件

社区

Superpowers 由 Jesse Vincent 和 Prime Radiant 的其他成员构建。

• Discord：加入我们进行社区支持、提问和分享你用 Superpowers 构建的内容
• Issues：https://github.com/obra/superpowers/issues
• 发布公告：注册以获取新版本通知