Heidi Labs
GitHub TrendingGitHub Trending 项目约 16 分钟6,342 字

Superpowers：面向编程智能体的完整软件开发方法论

本文目录

Superpowers#

Superpowers 是一套完整的软件开发方法论，面向你的编程智能体（coding agent）——它建立在若干可组合的技能（skills）之上，并附带一些初始指令，确保你的智能体确实会用到它们。

目录#

  • 工作原理
  • 商业服务
  • 快速开始
  • Claude Code
  • Antigravity
  • Codex App
  • Codex CLI
  • Cursor
  • Devin CLI
  • Factory Droid
  • Gemini CLI
  • GitHub Copilot CLI
  • Grok Build CLI
  • Kimi Code
  • OpenCode
  • Pi
  • Qwen Code
  • Hermes Agent
  • Muse
  • 基本工作流
  • 出问题时怎么办
  • 社区
  • 内部包含什么
  • 理念
  • 贡献
  • 更新
  • 许可证
  • 可视化配套功能的遥测

工作原理#

它从你启动编程智能体那一刻就开始了。一旦它看出你在构建某个东西，它不会立刻扑上去写代码。相反，它会先退一步，问你到底想做什么。

等它从对话里梳理出一份规格说明（spec）后，会以足够短、你能真正读完并消化的分块形式展示给你。

在你确认设计之后，你的智能体会整理出一份实施计划——清晰到足以让一位热情十足、品味糟糕、毫无判断力、不了解项目背景、还讨厌写测试的初级工程师照着执行。计划强调真正的红/绿 TDD（red/green TDD）、YAGNI（You Aren't Gonna Need It，你并不需要它）和 DRY。

接下来，一旦你说「开始」，它会启动一个由子智能体驱动的开发流程（subagent-driven-development）：让各个智能体逐个处理工程任务，检查并审查它们的工作，然后继续推进。你的智能体连续自主工作几个小时而不偏离你定下的计划，并不罕见。

还有更多内容，但以上就是这套系统的核心。而且因为技能是自动触发的，你不需要做任何特别的事。你的编程智能体就这样拥有了 Superpowers。

商业服务#

如果你在企业中使用 Superpowers，并且希望获得商业支持、额外工具或托管支出服务，欢迎写信给我们：sales@primeradiant.com。

安装#

安装方式因宿主（harness）而异。如果你使用多个宿主，请为每一个分别安装 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 会列出每个已安装技能的描述，而 using-superpowers 技能的描述会促使模型在对话开始时加载该技能。用同样的命令重新安装即可更新。

Codex App#

Superpowers 可通过官方 Codex 插件市场获取。

  1. 在 Codex 应用中，点击侧边栏里的 Plugins。
  2. 你应该会在 Coding 分类下看到 Superpowers。
  3. 点击 Superpowers 旁边的 +，按提示操作。

Codex CLI#

Superpowers 可通过官方 Codex 插件市场获取。

打开插件搜索界面：

/plugins

搜索 Superpowers：

superpowers

选择 Install Plugin。

Cursor#

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

/add-plugin superpowers

或者在插件市场中搜索「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#

Superpowers 可通过官方 Grok 插件市场获取。

从 xAI 官方市场安装插件：

grok plugin install superpowers@xai-official --trust

或者在 TUI 中打开市场，搜索 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：

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

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

Pi#

从本仓库将 Superpowers 作为 Pi 包安装：

pi install git:github.com/obra/superpowers

本地开发时，用这个检出目录作为临时包运行 Pi：

pi -e /path/to/superpowers

Pi 包会加载 Superpowers 的技能，以及一个小扩展，在会话启动时和压缩（compaction）之后再次注入 using-superpowers 引导。Pi 原生支持技能，所以不需要兼容性的 Skill 工具。子智能体和任务列表工具仍作为可选的 Pi 配套包提供。

Qwen Code#

Qwen Code 可直接从 Claude Code 市场安装插件。

从本仓库安装插件，并在提示时选择 superpowers：

qwen extensions install obra/superpowers

之后更新：

qwen extensions update superpowers

Hermes Agent#

从本仓库将 Superpowers 作为 Hermes 插件安装：

hermes plugins install obra/superpowers --enable

安装后重启所有活跃的 Hermes 会话。注意：Hermes 没有压缩后钩子，所以一个非常长的会话如果在第一轮之后发生压缩，就会丢失引导——如果技能不再触发，请开一个新会话。

Muse#

Superpowers 可作为原生 Muse 插件使用——同一个仓库、同一套技能、覆盖所有宿主。using-superpowers 引导通过原生 SessionStart 钩子注入，与 Claude Code、Codex、Cursor、Gemini、Pi 等一致——无需按会话手动启用。

从本地检出目录安装：

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 会话，以便 SessionStart 钩子生效——技能会立即生效，但钩子在首次安装时需要批准。要验证，请开启一个新会话并发送「Let's make a react todo list」——安装正常的版本会在写任何代码之前自动触发头脑风暴。版本号记录在 .version-bump.json 中，scripts/bump-version.sh 会让它保持同步。

基本工作流#

  • brainstorming（头脑风暴）—— 在构建任何东西之前激活。通过提问把你真正想要的东西及其原因引出来，让你把它描述清楚，然后把它理解的内容复述给你，供你纠正。小改动在聊天中达成一致；项目则产出一份编写者可以据以规划的设计文档。
  • using-git-worktrees —— 在设计获批后激活。在新分支上创建隔离的工作区，运行项目初始化，验证干净的测试基线。
  • writing-plans（编写计划）—— 在设计获批后激活。把工作拆成小块任务（每个 2–5 分钟）。每个任务都有确切的文件路径、完整的代码和验证步骤。
  • subagent-driven-development 或 executing-plans —— 随计划激活。要么为每个任务派发一个全新的子智能体，并在每次之后进行审查（最彻底），要么在当前会话中直接实现每个任务，最后对整个分支做一次全新审查（成本最低）。
  • test-driven-development（测试驱动开发）—— 在实现过程中激活。强制 RED-GREEN-REFACTOR：先写失败的测试，看着它失败，写最小代码，看着它通过，然后提交。删除在测试之前写下的代码。
  • requesting-code-review（请求代码审查）—— 在任务之间激活。对照计划审查，按严重程度报告问题。严重问题会阻断进度。
  • finishing-a-development-branch —— 在任务完成时激活。验证测试，给出选项（合并／PR／保留／丢弃），清理工作树。

智能体在任何任务之前都会检查相关技能。这些是强制工作流，不是建议。

出问题时怎么办#

有时一个会话会出问题：技能在不该触发时触发、该说话时沉默，或者智能体无视自己的计划、重复劳动、烧掉超出预期的 token。请让你的编程智能体「figure out what went wrong with superpowers in this session」（搞清楚这次会话里 Superpowers 出了什么问题），它就会调用 diagnosing-superpowers 技能。要检查更早的会话，请指明它：「figure out what went wrong with superpowers in session <id>」。

这个技能会读取会话记录，报告发生了什么并附上行级证据；如果你需要，还会打包成一个已做脱敏处理的包，用于提交缺陷报告。

社区#

Superpowers 由 Jesse Vincent 和 Prime Radiant 的其他人共同构建。

  • Discord：加入我们，获取社区支持、提问，以及分享你用 Superpowers 构建的东西
  • Issues：https://github.com/obra/superpowers/issues
  • 发布公告：注册以获取新版本通知

内部包含什么#

技能库

测试

  • test-driven-development —— RED-GREEN-REFACTOR 循环（包含测试反模式参考）

调试

  • 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 —— 技能系统简介

理念#

  • 测试驱动开发 —— 永远先写测试
  • 系统化胜过临时应对 —— 用流程取代猜测
  • 降低复杂度 —— 以简洁为首要目标
  • 证据胜过声称 —— 宣布成功之前先验证

阅读最初的发布公告。

贡献#

Superpowers 的通用贡献流程如下。请记住，我们通常不接受新技能的贡献，而且任何技能的更新都必须能在我们支持的所有编程智能体中工作。我们也不接受由智能体撰写的 PR 去修复别人提交的 issue，除非有维护者明确要求——即使你遇到了同样的问题；请把你的报告补充到已有的 issue 中。

  1. Fork 仓库
  2. 切换到 dev 分支
  3. 为你的工作创建一个分支
  4. 遵循 writing-skills 技能来创建和测试新增或修改的技能
  5. 提交 PR，填写 PR 模板的每一节，包括由人工用自己的话写出的摘要

技能行为测试使用来自 superpowers-evals 的 drill 评测工具，它会被克隆到 evals/——配置见 evals/README.md。插件基础设施测试位于 tests/，通过相应的 run-*.sh 或 npm test 运行。

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

更新#

Superpowers 的更新在某种程度上取决于所用的编程智能体，但通常是自动的。

许可证#

MIT License —— 详见 LICENSE 文件。

可视化配套功能的遥测#

因为技能和插件不会给创作者任何反馈，我们完全不知道有多少人在使用 Superpowers。默认情况下，brainstorming 可选的「可视化配套功能」上的 Prime Radiant 标志会从我们的网站加载。它会附带当前使用的 Superpowers 版本，但不包含任何关于你的项目、提示词或编程智能体的细节。我们看不到你的点击，也看不到你在构建什么。这帮助我们大致了解有多少人在用 Superpowers、用的是哪个版本。它完全是可选的。要关闭它，请把环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设为任意真值。Superpowers 也会遵循 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出选项。