Superpowers

Superpowers 是一套完整的软件开发工作流，专为编程代理设计，构建在一组可组合的"技能"之上，并通过初始指令确保你的代理正确使用它们。

工作原理

从你启动编程代理的那一刻开始。当它发现你正在构建某些东西时，它不会直接跳进去写代码。相反，它会退后一步，询问你真正想要做什么。

一旦从对话中梳理出规格说明，它会将设计分成足够短的片段展示给你，让你能够真正阅读和理解。

在你确认设计方案后，代理会制定一个足够清晰的实施计划，连一个热情但品味不佳、缺乏判断力、没有项目背景且厌恶测试的初级工程师都能遵循。它强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY。

接下来，当你说"开始"时，它会启动子代理驱动开发流程，让代理逐个完成工程任务，检查和审查它们的工作，然后继续推进。Claude 能够自主工作数小时而不偏离你制定的计划，这种情况并不罕见。

还有更多功能，但这是系统的核心。因为技能会自动触发，你不需要做任何特别的事情。你的编程代理就拥有了超能力。

如果 Superpowers 帮助你完成了赚钱的事情，并且你有此意愿，我非常感谢你能考虑赞助我的开源工作。

谢谢！

注意： 不同平台的安装方式不同。Claude Code 和 Cursor 有内置插件市场。Codex 和 OpenCode 需要手动设置。

在 Claude Code 中，首先注册市场：


/plugin marketplace add obra/superpowers-marketplace

然后从该市场安装插件：


/plugin install superpowers@superpowers-marketplace

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


/plugin-add superpowers

告诉 Codex：


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

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

告诉 OpenCode：


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

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

在你选择的平台启动一个新会话，请求一些应该触发技能的内容（例如，"帮我规划这个功能"或"让我们调试这个问题"）。代理应该自动调用相关的 superpowers 技能。

brainstorming（头脑风暴） - 在编写代码之前激活。通过提问细化粗略想法，探索替代方案，分段展示设计以供验证。保存设计文档。
using-git-worktrees（使用 Git 工作树） - 设计批准后激活。在新分支上创建隔离工作区，运行项目设置，验证干净的测试基线。
writing-plans（编写计划） - 设计批准后激活。将工作分解为小任务（每个 2-5 分钟）。每个任务都有精确的文件路径、完整代码、验证步骤。
subagent-driven-development（子代理驱动开发） 或 executing-plans（执行计划） - 计划制定后激活。为每个任务分派新的子代理，进行两阶段审查（规格合规性，然后代码质量），或带人工检查点的批量执行。
test-driven-development（测试驱动开发） - 实施过程中激活。强制执行红-绿-重构循环：编写失败的测试，看着它失败，编写最小代码，看着它通过，提交。删除在测试之前编写的代码。
requesting-code-review（请求代码审查） - 任务之间激活。对照计划审查，按严重程度报告问题。关键问题会阻止进度。
finishing-a-development-branch（完成开发分支） - 任务完成后激活。验证测试，展示选项（合并/PR/保留/丢弃），清理工作树。