超级能力

项目概述

Superpowers 是一套面向编码 Agent 的完整软件开发方法论。它由一组可组合的技能（skills）和初始指令构成，引导 Agent 在动手写代码之前先厘清用户意图。

工作原理

Agent 启动后并不会急于编写代码，而是先与用户交互，提炼出真正要解决的问题。一旦形成规格说明，便分块呈现供用户审阅。设计获得认可后，Agent 会生成一份细致到文件路径与验证步骤的实施计划，并严格遵循红绿重构（RED-GREEN-REFACTOR）的 TDD 流程，遵守 YAGNI 与 DRY 原则。

随后 Agent 启动子 Agent 驱动开发流程，按任务逐项执行、审查、推进，单次自主运行常可持续数小时。

安装方式

Superpowers 需要为每个开发环境单独安装。常见的安装命令如下：

• Claude Code

bash /plugin install superpowers@claude-plugins-official # 或使用 Superpowers 市场 /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace

• Antigravity：agy plugin install https://github.com/obra/superpowers
• Codex CLI：在 /plugins 界面搜索 superpowers 并安装
• Cursor：/add-plugin superpowers
• Devin CLI：devin plugins install obra/superpowers
• Gemini CLI：gemini extensions install https://github.com/obra/superpowers
• GitHub Copilot CLI：通过 copilot plugin marketplace add 注册后安装
• Kimi Code：在 /plugins 管理器中搜索安装
• OpenCode：让 OpenCode 读取远程 INSTALL.md
• Pi：pi install git:github.com/obra/superpowers
• Muse：muse plugins install ./，需执行 muse plugins approve superpowers 批准钩子

基本工作流

1. brainstorming：在动手前通过提问挖掘真实意图，小改动直接在对话中确认，复杂项目则生成设计文档。
2. using-git-worktrees：设计获批后创建隔离工作区与新分支，验证测试基线。
3. writing-plans：将工作拆分为 2 到 5 分钟的小任务，每项给出文件路径、完整代码与验证步骤。
4. subagent-driven-development 或 executing-plans：前者为每个任务派发独立子 Agent 逐个审查，后者由当前会话内联执行并在末尾统一审查。
5. test-driven-development：强制执行红绿重构流程，先写失败测试，再写最小实现，最后提交。
6. requesting-code-review：在任务之间根据计划审查，严重问题会阻断推进。
7. finishing-a-development-branch：任务完成后核对测试，并给出合并、PR、保留或丢弃等选项。

Agent 在执行任何任务前都会检查相关技能，这些工作流是强制性的。

异常诊断

若会话中技能触发异常或偏离计划，可要求 Agent “figure out what went wrong with superpowers in this session”，将调用 diagnosing-superpowers 技能。它会读取会话记录，给出带证据的诊断，并可导出脱敏后的故障报告包。

技能库概览

• 测试：test-driven-development
• 调试：systematic-debugging、verification-before-completion、diagnosing-superpowers
• 协作：brainstorming、writing-plans、executing-plans、dispatching-parallel-agents、requesting-code-review、receiving-code-review、using-git-worktrees、finishing-a-development-branch、subagent-driven-development
• 元技能：writing-skills、using-superpowers

设计理念

• 测试驱动开发，永远先写测试
• 系统化流程优先于临时猜测
• 以简化复杂度为首要目标
• 用证据而非断言来判定成功

贡献与更新

项目不接受新增技能的贡献，任何技能更新需兼容所有受支持的 Agent。贡献流程为：fork 仓库、切换到 dev 分支、新建分支、遵循 writing-skills 技能开发、提交 PR。技能行为测试使用 superpowers-evals 中的 drill eval 框架，插件基础设施测试位于 tests/ 目录。

Superpowers 的更新通常自动进行，具体因 Agent 而异。

许可与遥测

项目采用 MIT 许可证。默认情况下，brainstorming 的可视化伴读功能会从官网加载一个包含版本号的徽标，不涉及项目内容、提示词或点击行为。若需关闭，可设置环境变量 SUPERPOWERS_DISABLE_TLEMETRY 为真值，同时也会尊重 Claude Code 的 DISABLE_TELEMETRY 与 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 选项。