超能力（superpowers）

技能介绍

Superpowers（超能力）是一套面向编码智能体的完整软件开发方法论：由一组可组合的技能（skills）和一些初始指令构成，确保智能体真正用上这些技能。技能会自动触发，无需任何特殊操作——安装之后，你的编码智能体就拥有了「超能力」。

它由 Jesse Vincent 与 Prime Radiant 团队构建，MIT 开源，支持 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等 15 种以上编码工具（harness）。

适用场景

  • 在 Claude Code、Codex、Cursor、Devin、Gemini CLI、OpenCode、Qwen Code 等编码工具中做软件开发（使用多个工具时需分别安装）
  • 希望智能体先厘清真实需求、产出设计文档与实现计划，再动手写代码的项目
  • 需要智能体按测试驱动开发流程、自主完成多个工程任务并自我审查的中大型开发任务
  • 会话出现异常（技能误触发/该触发时不触发、忽略计划、重复工作、token 消耗异常）时的自我诊断

核心能力

技能库分为四组（技能名保留原文标识）：

测试

  • test-driven-development —— 红-绿-重构循环（含测试反模式参考）

调试

  • systematic-debugging —— 四阶段根因排查流程（含根因追踪、纵深防御、条件等待技巧）
  • verification-before-completion —— 确认真修好了再收工
  • diagnosing-superpowers —— 用证据定位某个会话里出了什么问题，可导出脱敏包或提交 issue

协作

  • brainstorming —— 动手前先挖出真实意图
  • writing-plans —— 详细实现计划
  • executing-plans —— 当前会话内执行计划：单一上下文、最后一次整体评审
  • dispatching-parallel-agents —— 并发子智能体工作流
  • requesting-code-review —— 评审前检查清单
  • receiving-code-review —— 回应评审反馈
  • using-git-worktrees —— 并行开发分支
  • finishing-a-development-branch —— 合并/PR/保留/丢弃的收尾流程
  • subagent-driven-development —— 子智能体快速迭代 + 两阶段评审（先规格符合性、后代码质量）

元技能

  • writing-skills —— 按最佳实践创建新技能（含测试方法）
  • using-superpowers —— 技能系统入门

设计哲学：始终测试先行（TDD）；系统化胜过即兴；把降低复杂度作为首要目标；证据胜过断言。

工作方式

从你启动编码智能体的那一刻开始：一旦发现你要构建东西，它不会直接闷头写代码，而是先退一步，问你到底想做什么、为什么。从对话中整理出规格说明后，会切成足够短的片段给你审阅消化。你确认设计后，它会制定一份实现计划——清晰到「一个热情但品味差、没判断力、不了解项目背景、还不爱写测试的初级工程师」也能照着做；计划强调真正的红/绿 TDD、YAGNI（不过度设计）和 DRY。你说一声「go」，它就启动子智能体驱动开发（subagent-driven-development）流程：逐个工程任务派发智能体执行、检查评审其产出，再继续推进。智能体常常一次自主工作数小时而不偏离你们定下的计划。

基础工作流（技能按序自动激活，是强制流程而非建议）：

  1. brainstorming —— 构建任何东西之前激活。通过提问引导你描述真正想要什么、为什么，再复述它的理解供你纠正。小改动在对话里达成一致；项目则产出一份可供施工的设计文档。
  2. using-git-worktrees —— 设计确认后激活。在新分支上创建隔离工作区，运行项目初始化，验证测试基线干净。
  3. writing-plans —— 拿到确认的设计后激活。把工作拆成 2-5 分钟的小任务；每个任务都有精确文件路径、完整代码、验证步骤。
  4. subagent-driven-development 或 executing-plans —— 拿到计划后激活。要么每个任务派一个全新子智能体执行、任务后评审（最彻底），要么在当前会话内逐个实现、最后对整个分支做一次全新评审（最省）。
  5. test-driven-development —— 实现过程中激活。强制红-绿-重构：先写失败的测试、看它失败、写最小实现、看它通过、提交。测试之前写的代码一律删除。
  6. requesting-code-review —— 任务之间激活。对照计划评审，按严重程度报告问题；严重问题会阻断进度。
  7. finishing-a-development-branch —— 任务全部完成时激活。验证测试，给出选项（合并/PR/保留/丢弃），清理 worktree。

出问题时：如果某个会话行为异常，让编码智能体「figure out what went wrong with superpowers in this session」，它会调用 diagnosing-superpowers 技能；要查更早的会话就指名会话 id：「figure out what went wrong with superpowers in session ``」。该技能会读取会话记录、用行级证据报告发生了什么，还可以打包一份脱敏材料用于提交 bug。

你需要提供

  • 你的真实意图：智能体通过提问引导你说出要做什么、为什么（小改动在对话里说清即可，项目需要确认设计文档）
  • 对设计与实现计划的确认（签收设计、说「go」开工）
  • 在所用的每个编码工具里各安装一次

你会获得

  • 分块呈现、能真正读懂的设计文档，以及精确到文件路径、含完整代码与验证步骤的实现计划
  • 子智能体驱动的自主开发：一次可连续数小时工作而不偏离计划
  • 全程红/绿 TDD、任务间代码审查、分支收尾（合并/PR/保留/丢弃）与 worktree 清理
  • 技能自动触发，无需学习额外操作；更新随各编码工具的插件机制，多数情况自动完成

使用示例

安装

安装方式因 harness 而异；使用多个工具时需分别安装。以下命令原样摘自官方 README。

Claude Code（官方插件市场）：

/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 App / Codex CLI（官方插件市场 https://github.com/openai/plugins；App 在侧边栏 Plugins → Coding 分区点 + 安装）：

/plugins
superpowers

Cursor：

/add-plugin superpowers

Devin CLI：

devin plugins install obra/superpowers
devin plugins update 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

GitHub Copilot CLI：

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Grok Build CLI（xAI 官方市场）：

grok plugin install superpowers@xai-official --trust

Kimi Code（插件管理器 /plugins → Marketplace > Superpowers 安装，或直接）：

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

OpenCode：

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

Pi：

pi install git:github.com/obra/superpowers

Qwen Code（从 Claude Code 市场安装，提示时选 superpowers）：

qwen extensions install obra/superpowers
qwen extensions update superpowers

Hermes Agent：

hermes plugins install obra/superpowers --enable

Muse：

muse plugins install ./
muse plugins approve superpowers

或克隆后安装：

git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowers
muse plugins update superpowers

验证安装

原文以 Muse 为例：新建会话发一句 Let's make a react todo list——安装正常会在写任何代码之前自动触发 brainstorming。

禁用遥测

默认情况下 brainstorming 的可选可视化伴侣会从官网加载 Prime Radiant 标志（仅含 Superpowers 版本号，不含项目、提示词或智能体信息）。如需关闭：

SUPERPOWERS_DISABLE_TELEMETRY=<任意真值>

也支持 Claude Code 的 DISABLE_TELEMETRY 与 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC。