obra/superpowers

Source: https://github.com/obra/superpowers

Superpowers

Superpowers 是一套完整的软件开发方法论，专为你的编码代理（coding agents）设计，它基于一组可组合的技能和一些初始指令构建，确保你的代理能够正确使用这些技能。

快速开始

让你的代理拥有 Superpowers：Claude Code, Codex CLI, Codex App, Factory Droid, Gemini CLI, OpenCode, Cursor, GitHub Copilot CLI.

工作原理

一切始于你启动编码代理的那一刻。一旦它发现你在构建某个项目，它不会立即跳入编写代码的环节。相反，它会退一步，询问你真正想要实现的目标。

一旦从对话中提炼出规格说明，它会以短小精悍、易于阅读和理解的片段展示给你。

在你确认设计方案后，你的代理会制定一份清晰的实施计划，清晰到足以让一位充满热情但品味欠佳、缺乏判断力、没有项目背景且排斥测试的初级工程师也能跟随执行。它强调真正的红/绿测试驱动开发（TDD）、YAGNI（You Aren’t Gonna Need It，你不会需要它）以及 DRY（Don’t Repeat Yourself，不要重复自己）。

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

这里还有很多更多内容，但这便是系统的核心。而且由于技能是自动触发的，你不需要做任何特别的操作。你的编码代理就拥有了 Superpowers。

赞助

如果 Superpowers 帮助你完成了能赚钱的工作，并且你有意愿，我非常感激你能考虑赞助我的开源工作 (https://github.com/sponsors/obra)。

谢谢！

• Jesse

安装

安装方式因所使用的基础设施（harness）而异。如果你使用多个基础设施，请为每一个分别安装 Superpowers。

Claude Code

Superpowers 可通过官方 Claude 插件市场获取 (https://claude.com/plugins/superpowers)

官方市场

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

  /plugin install superpowers@claude-plugins-official
  

Superpowers 市场

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

• 注册市场：

  /plugin marketplace add obra/superpowers-marketplace
  

• 从该市场安装插件：

  /plugin install superpowers@superpowers-marketplace
  

Codex CLI

Superpowers 可通过官方 Codex 插件市场获取 (https://github.com/openai/plugins)。

• 打开插件搜索界面：

  /plugins
  

• 搜索 Superpowers：

  superpowers
  

• 选择 Install Plugin（安装插件）。

Codex App

Superpowers 可通过官方 Codex 插件市场获取 (https://github.com/openai/plugins)。

• 在 Codex 应用中，点击侧边栏中的 Plugins（插件）。
• 你应该能在 Coding 部分看到 Superpowers。
• 点击 Superpowers 旁边的 + 并跟随提示操作。

Factory Droid

• 注册市场：

  droid plugin marketplace add https://github.com/obra/superpowers
  

• 安装插件：

  droid plugin install superpowers@superpowers
  

Gemini CLI

• 安装扩展：

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

• 稍后更新：

  gemini extensions update superpowers
  

OpenCode

OpenCode 使用其自身的插件安装方式；即使你在其他基础设施中已使用 Superpowers，也需在此单独安装。

• 告诉 OpenCode：

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

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

Cursor

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

  /add-plugin superpowers
  

• 或者在插件市场中搜索 “superpowers”。

GitHub Copilot CLI

• 注册市场：

  copilot plugin marketplace add obra/superpowers-marketplace
  

• 安装插件：

  copilot plugin install superpowers@superpowers-marketplace
  

基本工作流

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

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

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/保留/丢弃），清理 worktree。

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

内部构成

技能库

测试

• 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 Worktrees） - 并行开发分支
• finishing-a-development-branch（完成开发分支） - 合并/PR 决策工作流
• subagent-driven-development（子代理驱动开发） - 带有两阶段审查（规格合规性，然后代码质量）的快速迭代

元技能（Meta）

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

理念

• 测试驱动开发 - 始终先写测试
• 系统化而非临时应对 - 流程胜过猜测
• 降低复杂性 - 简单性是首要目标
• 证据胜过主张 - 在宣告成功之前先验证

阅读原始发布公告 (https://blog.fsck.com/2025/10/09/superpowers/)。

贡献

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

1. Fork 仓库
2. 切换到 dev 分支
3. 为你的工作创建一个分支
4. 遵循 writing-skills 技能来创建和测试新的及修改后的技能
5. 提交 PR，务必填写拉取请求模板。

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

更新

Superpowers 的更新在一定程度上依赖于所使用的编码代理，但通常是自动进行的。

许可证

MIT License - 详见 LICENSE 文件

社区

Superpowers 由 Jesse Vincent (https://blog.fsck.com) 和 Prime Radiant 的其他成员 (https://primeradiant.com) 构建。

• Discord: 加入 (https://discord.gg/35wsABTejz) 以获取社区支持、提问以及分享你使用 Superpowers 构建的内容
• Issues: https://github.com/obra/superpowers/issues
• 发布公告: 订阅 (https://primeradiant.com/superpowers/) 以获取新版本通知