Superpowers

Superpowers 是一套面向编码 Agent 的完整软件开发方法论。它建立在一组可组合 skills 和一段启动指令之上，用来确保 Agent 在工作时真的会调用这些方法。

我们正在招聘

我们正在招聘一位全职同事，协助 Superpowers 社区和代码相关工作。职位信息见 https://primeradiant.com/jobs/superpowers-community-engineer/ 。

如果你认识合适的人，欢迎推荐给我们。

快速开始

为你的 Agent 安装 Superpowers：Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。

工作方式

它从你启动编码 Agent 的那一刻开始工作。只要 Agent 发现你正在构建某个东西，它不会直接跳进写代码。

它会先退一步，问清楚你真正想做什么。等它从对话中梳理出规格说明后，会把内容分成足够短、便于阅读和消化的片段展示给你。

当你确认设计方案后，Agent 会整理一份实现计划。这份计划清晰到一个热情但缺少判断力、没有项目上下文、也不爱写测试的初级工程师都能照着执行。它强调真正的红 / 绿 TDD、YAGNI（你不需要的东西就别做）和 DRY。

接下来，只要你说开始，它会启动 subagent-driven-development 流程，让多个 Agent 处理工程任务、检查并审阅它们的工作，然后继续推进。

让 Agent 按计划自主工作几个小时而不跑偏，并不罕见。系统里还有更多细节，但这就是核心。因为这些 skills 会自动触发，所以你不需要做额外动作。

你的编码 Agent 会直接拥有 Superpowers。

商业服务

如果你在企业环境中使用 Superpowers，并且需要商业支持、额外工具或托管预算管理，请联系 sales@primeradiant.com。

安装

不同 Agent 运行环境的安装方式不同。如果你同时使用多个环境，需要分别安装 Superpowers。

Claude Code

Superpowers 可通过 Claude 官方插件市场安装。

官方市场

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

/plugin install superpowers@claude-plugins-official

Superpowers 市场

Superpowers 市场提供 Superpowers 以及其他相关 Claude Code 插件。

• 注册市场：

/plugin marketplace add obra/superpowers-marketplace

• 从该市场安装插件：

/plugin install superpowers@superpowers-marketplace

Antigravity

从此仓库安装 Superpowers 插件：

agy plugin install https://github.com/obra/superpowers

Antigravity 会运行插件的 session-start hook，所以 Superpowers 会从第一条消息开始生效。用同一条命令重新安装即可更新。

Codex App

Superpowers 可通过官方 Codex 插件市场安装。

• 在 Codex app 侧边栏点击 Plugins。
• 你应该能在 Coding 分区看到 Superpowers。
• 点击 Superpowers 旁边的 +，然后按提示操作。

Codex CLI

Superpowers 可通过官方 Codex 插件市场安装。

• 打开插件搜索界面：

/plugins

• 搜索 Superpowers：

superpowers

• 选择 Install Plugin。

Cursor

• 在 Cursor Agent chat 中从市场安装：

/add-plugin superpowers

• 或在插件市场搜索 superpowers。

Factory Droid

• 注册市场：

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

• 安装插件：

droid plugin install superpowers@superpowers

GitHub Copilot CLI

• 注册市场：

copilot plugin marketplace add obra/superpowers-marketplace

• 安装插件：

copilot plugin install superpowers@superpowers-marketplace

Kimi Code

Superpowers 可在 Kimi Code 的插件市场中安装。

• 打开 Kimi Code 的插件管理器：

/plugins

• 进入 Marketplace > Superpowers 并安装。
• 或直接从此仓库安装：

/plugins install https://github.com/obra/superpowers

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

OpenCode

OpenCode 使用自己的插件安装方式。即使你已经在其他运行环境中使用 Superpowers，也需要为 OpenCode 单独安装。

• 告诉 OpenCode：

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

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

Pi

从此仓库把 Superpowers 安装为 Pi package：

pi install git:github.com/obra/superpowers

本地开发时，可以让 Pi 临时加载这个 checkout：

pi -e /path/to/superpowers

Pi package 会加载 Superpowers skills，并通过一个小扩展在会话开始时注入 using-superpowers bootstrap；上下文压缩后也会再次注入。

Pi 原生支持 skills，所以不需要额外的兼容性 Skill 工具。Subagent 和任务列表工具仍然可以作为可选的 Pi companion packages。

基础工作流

1. brainstorming - 写代码前触发。通过提问澄清粗略想法，探索替代方案，分段展示设计并等待确认，最后保存设计文档。
2. using-git-worktrees - 设计通过后触发。创建新分支上的隔离工作区，执行项目初始化，并确认测试基线干净。
3. writing-plans - 设计通过后触发。把工作拆成 2-5 分钟一项的小任务；每个任务都包含精确文件路径、完整代码和验证步骤。
4. subagent-driven-development 或 executing-plans - 有计划后触发。为每个任务派发新的 subagent，并做两阶段审阅（先审规格符合度，再审代码质量）；或按批次执行并设置人工检查点。
5. test-driven-development - 实现过程中触发。强制 RED-GREEN-REFACTOR：先写失败测试，确认失败，再写最小代码，确认通过，最后提交。会删除测试前写出的代码。
6. requesting-code-review - 任务之间触发。按计划审阅，按严重程度报告问题；关键问题会阻塞继续推进。
7. finishing-a-development-branch - 任务完成后触发。验证测试，提供合并、PR、保留或丢弃等选项，并清理 worktree。

Agent 会在任何任务开始前检查相关 skills。 这些是强制工作流，不是建议。

包含内容

Skills Library

Testing

• test-driven-development - RED-GREEN-REFACTOR 循环，包含测试反模式参考。

Debugging

• systematic-debugging - 四阶段根因分析流程，包含 root-cause-tracing、defense-in-depth、condition-based-waiting 技术。
• verification-before-completion - 确保问题真的被修复。

Collaboration

• brainstorming - 苏格拉底式设计澄清。
• writing-plans - 详细实现计划。
• executing-plans - 带检查点的批量执行。
• dispatching-parallel-agents - 并发 subagent 工作流。
• requesting-code-review - 预审检查清单。
• receiving-code-review - 处理代码审阅反馈。
• using-git-worktrees - 并行开发分支。
• finishing-a-development-branch - 合并 / PR 决策工作流。
• subagent-driven-development - 通过两阶段审阅快速迭代（先规格符合度，后代码质量）。

Meta

• writing-skills - 按最佳实践创建新 skills，包含测试方法。
• using-superpowers - skills 系统介绍。

理念

• Test-Driven Development - 永远先写测试。
• Systematic over ad-hoc - 用流程代替猜测。
• Complexity reduction - 把简单作为首要目标。
• Evidence over claims - 先验证，再宣称完成。

阅读原始发布说明：https://blog.fsck.com/2025/10/09/superpowers/ 。

贡献

Superpowers 的通用贡献流程如下。请注意，我们通常不接受新增 skills 的贡献；任何对 skills 的更新也必须能在所有受支持的编码 Agent 上工作。

1. Fork 仓库。
2. 切换到 dev 分支。
3. 为你的工作创建分支。
4. 按 writing-skills skill 创建并测试新增或修改后的 skills。
5. 提交 PR，并确保填写 PR 模板。

Skill 行为测试使用 superpowers-evals 的 drill eval harness，克隆到 evals/ 目录；设置方式见 evals/README.md。

插件基础设施测试位于 tests/，通过对应的 run-*.sh 或 npm test 运行。完整指南见 skills/writing-skills/SKILL.md。

更新 Superpowers

Superpowers 的更新方式会因编码 Agent 而异，但通常会自动完成。

许可证

MIT License，详见 LICENSE 文件。

可视化 companion telemetry

因为 skills 和插件不会向创建者提供反馈，我们并不知道有多少人在使用 Superpowers。

默认情况下，brainstorming 可选可视化 companion 功能中的 Prime Radiant logo 会从我们的网站加载。它包含正在使用的 Superpowers 版本，不包含你的项目、提示词或编码 Agent 的任何细节。我们看不到你的点击，也看不到你正在构建什么。

这能帮助我们粗略了解有多少人在使用 Superpowers，以及大家使用的是哪个版本。它完全可选。

要禁用它，请把环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设置为任意 true 值。Superpowers 也尊重 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出选项。

社区

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

• Discord：加入社区获取支持、提问，并分享你用 Superpowers 构建的东西：https://discord.gg/35wsABTejz
• Issues：https://github.com/obra/superpowers/issues
• Release announcements：订阅新版通知：https://primeradiant.com/superpowers/

Superpowers

Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them.

We're Hiring!

We're hiring someone to help out full time with Superpowers community and code work. You can read about the job at https://primeradiant.com/jobs/superpowers-community-engineer/ If this sounds like someone you know, definitely send them our way.

Quickstart

Give your agent Superpowers: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, GitHub Copilot CLI, Kimi Code, OpenCode, Pi.

How it works

It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it doesn't just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do.

Once it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest.

After you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY.

Next up, once you say "go", it launches a subagent-driven-development process, having agents work through each engineering task, inspecting and reviewing their work, and continuing forward. It's not uncommon for your agent to work autonomously for a couple hours at a time without deviating from the plan you put together.

There's a bunch more to it, but that's the core of the system. And because the skills trigger automatically, you don't need to do anything special. Your coding agent just has Superpowers.

Commercial Services

If you're using Superpowers in enterprise and could benefit from commercial support, additional tooling, or managed spending, please don't hesitate to drop us a line at sales@primeradiant.com.

Installation

Installation differs by harness. If you use more than one, install Superpowers separately for each one.

Claude Code

Superpowers is available via the official Claude plugin marketplace

Official Marketplace

• Install the plugin from Anthropic's official marketplace:

``bash /plugin install superpowers@claude-plugins-official ``

Superpowers Marketplace

The Superpowers marketplace provides Superpowers and some other related plugins for Claude Code.

• Register the marketplace:

``bash /plugin marketplace add obra/superpowers-marketplace ``

• Install the plugin from this marketplace:

``bash /plugin install superpowers@superpowers-marketplace ``

Antigravity

Install Superpowers as a plugin from this repository:

agy plugin install https://github.com/obra/superpowers

Antigravity runs the plugin's session-start hook, so Superpowers is active from the first message. Reinstall with the same command to update.

Codex App

Superpowers is available via the official Codex plugin marketplace.

• In the Codex app, click on Plugins in the sidebar.
• You should see Superpowers in the Coding section.
• Click the + next to Superpowers and follow the prompts.

Codex CLI

Superpowers is available via the official Codex plugin marketplace.

• Open the plugin search interface:

``bash /plugins ``

• Search for Superpowers:

``bash superpowers ``

• Select Install Plugin.

Cursor

• In Cursor Agent chat, install from marketplace:

``text /add-plugin superpowers ``

• Or search for "superpowers" in the plugin marketplace.

Factory Droid

• Register the marketplace:

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

• Install the plugin:

``bash droid plugin install superpowers@superpowers ``

GitHub Copilot CLI

• Register the marketplace:

``bash copilot plugin marketplace add obra/superpowers-marketplace ``

• Install the plugin:

``bash copilot plugin install superpowers@superpowers-marketplace ``

Kimi Code

Superpowers is available in Kimi Code's plugin marketplace.

• Open Kimi Code's plugin manager:

``text /plugins ``

• Go to Marketplace > Superpowers and install it.

• Or install directly from this repository:

``text /plugins install https://github.com/obra/superpowers ``

• Detailed docs: docs/README.kimi.md

OpenCode

OpenCode uses its own plugin install; install Superpowers separately even if you already use it in another harness.

• Tell OpenCode:

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

• Detailed docs: docs/README.opencode.md

Pi

Install Superpowers as a Pi package from this repository:

pi install git:github.com/obra/superpowers

For local development, run Pi with this checkout loaded as a temporary package:

pi -e /path/to/superpowers

The Pi package loads the Superpowers skills and a small extension that injects the using-superpowers bootstrap at session startup and again after compaction. Pi has native skills, so no compatibility Skill tool is required. Subagent and task-list tools remain optional Pi companion packages.

The Basic Workflow

1. brainstorming - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.

1. using-git-worktrees - Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline.

1. writing-plans - Activates with approved design. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps.

1. subagent-driven-development or executing-plans - Activates with plan. Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality), or executes in batches with human checkpoints.

1. test-driven-development - Activates during implementation. Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. Deletes code written before tests.

1. requesting-code-review - Activates between tasks. Reviews against plan, reports issues by severity. Critical issues block progress.

1. finishing-a-development-branch - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.

The agent checks for relevant skills before any task. Mandatory workflows, not suggestions.

What's Inside

Skills Library

Testing

• test-driven-development - RED-GREEN-REFACTOR cycle (includes testing anti-patterns reference)

Debugging

• systematic-debugging - 4-phase root cause process (includes root-cause-tracing, defense-in-depth, condition-based-waiting techniques)
• verification-before-completion - Ensure it's actually fixed

Collaboration

• brainstorming - Socratic design refinement
• writing-plans - Detailed implementation plans
• executing-plans - Batch execution with checkpoints
• dispatching-parallel-agents - Concurrent subagent workflows
• requesting-code-review - Pre-review checklist
• receiving-code-review - Responding to feedback
• using-git-worktrees - Parallel development branches
• finishing-a-development-branch - Merge/PR decision workflow
• subagent-driven-development - Fast iteration with two-stage review (spec compliance, then code quality)

Meta

• writing-skills - Create new skills following best practices (includes testing methodology)
• using-superpowers - Introduction to the skills system

Philosophy

• Test-Driven Development - Write tests first, always
• Systematic over ad-hoc - Process over guessing
• Complexity reduction - Simplicity as primary goal
• Evidence over claims - Verify before declaring success

Read the original release announcement.

Contributing

The general contribution process for Superpowers is below. Keep in mind that we don't generally accept contributions of new skills and that any updates to skills must work across all of the coding agents we support.

1. Fork the repository
2. Switch to the 'dev' branch
3. Create a branch for your work
4. Follow the writing-skills skill for creating and testing new and modified skills
5. Submit a PR, being sure to fill in the pull request template.

Skill-behavior tests use the drill eval harness from superpowers-evals, cloned into evals/ — see evals/README.md for setup. Plugin-infrastructure tests live at tests/ and run via the relevant run-*.sh or npm test.

See skills/writing-skills/SKILL.md for the complete guide.

Updating

Superpowers updates are somewhat coding-agent dependent, but are often automatic.

License

MIT License - see LICENSE file for details

Visual companion telemetry

Because skills and plugins don't provide any feedback to creators, we have no idea how many of you are using Superpowers. By default, the Prime Radiant logo on brainstorming's optional visual companion feature is loaded from our website. It includes the version of Superpowers in use. It does not include any details about your project, prompt, or coding agent. We don't see your clicks or anything about what you're building. This helps us have a rough idea of how many folks are using Superpowers and which version of Superpowers they're using. It's 100% optional. To disable this, set the environment variable SUPERPOWERS_DISABLE_TELEMETRY to any true value. Superpowers also honors Claude Code's DISABLE_TELEMETRY and CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC opt-outs.

Community

Superpowers is built by Jesse Vincent and the rest of the folks at Prime Radiant.

• Discord: Join us for community support, questions, and sharing what you're building with Superpowers
• Issues: https://github.com/obra/superpowers/issues
• Release announcements: Sign up to get notified about new versions