obra / 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. Superpowers 是一套为你的编程智能体（coding agents）设计的完整软件开发方法论，它构建于一系列可组合的技能和初始指令之上，确保你的智能体能够有效运用这些能力。

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. 在你确认设计方案后，智能体会制定一份实施计划。这份计划清晰到即使是一位充满热情但品味欠佳、缺乏判断力、不了解项目背景且厌恶测试的初级工程师也能照做。它强调真正的红/绿测试驱动开发（TDD）、YAGNI（你不会需要它）原则以及 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 Claude to be able 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. 接下来，当你发出“开始”指令后，它会启动“子智能体驱动开发”流程，让智能体逐一完成各项工程任务，并对工作成果进行检查和评审，然后继续推进。Claude 经常能够自主工作数小时而不偏离你制定的计划。系统核心逻辑大抵如此，还有更多细节，但这就是系统的精髓。由于这些技能会自动触发，你无需进行任何特殊操作，你的编程智能体就直接拥有了“超能力”（Superpowers）。

Sponsorship

赞助

If Superpowers has helped you do stuff that makes money and you are so inclined, I’d greatly appreciate it if you’d consider sponsoring my opensource work. Thanks! Jesse 如果 Superpowers 帮助你完成了能够盈利的工作，且你愿意的话，非常感谢你能考虑赞助我的开源工作。谢谢！—— Jesse

Installation

安装指南

Note: Installation differs by platform. 注意：安装方式因平台而异。

Claude Code Official Marketplace Claude Code 官方市场 Superpowers is available via the official Claude plugin marketplace. Install the plugin from Anthropic’s official marketplace: /plugin install superpowers@claude-plugins-official Superpowers 可通过 Claude 官方插件市场获取。请从 Anthropic 官方市场安装插件： /plugin install superpowers@claude-plugins-official

Claude Code (Superpowers Marketplace) Claude Code (Superpowers 市场) The Superpowers marketplace provides Superpowers and some other related plugins for Claude Code. In Claude Code, register the marketplace first: /plugin marketplace add obra/superpowers-marketplace Then install the plugin from this marketplace: /plugin install superpowers@superpowers-marketplace Superpowers 市场为 Claude Code 提供 Superpowers 及其他相关插件。在 Claude Code 中，首先注册该市场： /plugin marketplace add obra/superpowers-marketplace 然后从该市场安装插件： /plugin install superpowers@superpowers-marketplace

OpenAI Codex CLI Open plugin search interface /plugins, search for “Superpowers”, select “Install Plugin”. 打开插件搜索界面 /plugins，搜索 “Superpowers”，选择“安装插件”。

OpenAI Codex App 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 应用中，点击侧边栏的“插件”。你应该能在“编程”部分看到 Superpowers。点击 Superpowers 旁边的“+”号并按照提示操作。

Cursor (via Plugin Marketplace) In Cursor Agent chat, install from marketplace: /add-plugin superpowers or search for “superpowers” in the plugin marketplace. 在 Cursor Agent 聊天窗口中，通过市场安装：/add-plugin superpowers，或者在插件市场中搜索 “superpowers”。

OpenCode Tell OpenCode: Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md 告诉 OpenCode：Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.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 To update: gemini extensions update superpowers 更新命令：gemini extensions update superpowers

The Basic Workflow

基础工作流

brainstorming: Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document. 头脑风暴：在编写代码前激活。通过提问细化粗略的想法，探索替代方案，分段展示设计以供验证，并保存设计文档。
using-git-worktrees: Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline. 使用 Git 工作树：在设计获批后激活。在新的分支上创建隔离的工作区，运行项目设置，并验证干净的测试基准。
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. 编写计划：在设计获批后激活。将工作拆解为小任务（每个 2-5 分钟）。每个任务都包含确切的文件路径、完整代码和验证步骤。
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. 子智能体驱动开发或执行计划：在计划确定后激活。为每个任务分派新的子智能体，进行两阶段评审（规格合规性，然后是代码质量），或分批执行并设置人工检查点。
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. 测试驱动开发：在实施过程中激活。强制执行“红-绿-重构”循环：编写失败测试，观察其失败，编写最少代码，观察其通过，提交。删除在测试之前编写的代码。
requesting-code-review: Activates between tasks. Reviews against plan, reports issues by severity. Critical issues block progress. 请求代码评审：在任务之间激活。根据计划进行评审，按严重程度报告问题。严重问题会阻塞进度。
finishing-a-development-branch: Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree. 完成开发分支：在任务完成后激活。验证测试，提供选项（合并/PR/保留/丢弃），并清理工作树。

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) 测试：test-driven-development（红-绿-重构循环）
Debugging: systematic-debugging (4-phase root cause process), verification-before-completion 调试：systematic-debugging（四阶段根本原因分析流程），verification-before-completion（完成前验证）
Collaboration: brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development 协作：头脑风暴、编写计划、执行计划、并行智能体分派、请求代码评审、接收代码评审、使用 Git 工作树、完成开发分支、子智能体驱动开发
Meta: writing-skills (Create new skills), using-superpowers 元技能：writing-skills（创建新技能）、using-superpowers（技能系统介绍）

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. 证据重于声明：在宣布成功前先进行验证。

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. Superpowers 的通用贡献流程如下。请注意，我们通常不接受新技能的贡献，且任何对现有技能的更新都必须兼容我们支持的所有编程智能体。

Fork the repository Fork 本仓库
Switch to the ‘dev’ branch 切换到 ‘dev’ 分支
Create a branch for your work 为你的工作创建分支
Follow the writing-skills skill for creating and testing new and modified skills 遵循 writing-skills 技能来创建和测试新的或修改后的技能