obra superpowers

obra superpowers

Superpowers 是一套完整的软件开发方法论，专为你的编码智能体打造，建立在一组可组合的技能以及一些初始指令之上，确保你的智能体会使用这些技能。

目录

• 工作原理
• 商业服务
• 快速上手
• Claude Code
• Antigravity
• Codex App
• Codex CLI
• Cursor
• Devin CLI
• Factory Droid
• Gemini CLI
• GitHub Copilot CLI
• Grok Build CLI
• Kimi Code
• OpenCode
• Pi
• Hermes Agent
• 基本工作流程
• 社区
• 内容概览
• 理念
• 贡献
• 更新
• 许可证
• 可视化配套遥测

工作原理

一切从你启动编码智能体的那一刻开始。一旦它发现你在构建某个东西，它不会直接跳进去尝试写代码。相反，它会退后一步，问你到底想做什么。

一旦它从对话中梳理出一份规格说明，就会以足够短、真正能读完并消化的分段形式展示给你。

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

接下来，一旦你说“开始”，它就会启动一个子智能体驱动的开发流程，让各个智能体逐项完成每个工程任务，检查并审查它们的工作，然后继续推进。你的智能体一次自主工作几个小时而不偏离你制定的计划，这并不罕见。

还有更多内容，但以上就是这个系统的核心。而且由于这些技能会自动触发，你不需要做任何特殊操作。你的编码智能体自然就拥有 Superpowers。

商业服务

如果你在企业中使用 Superpowers，并且能从商业支持、额外工具或托管支出中获益，请随时发邮件至 sales@primeradiant.com 与我们联系。

安装

安装方式因运行环境而异。如果你使用多个环境，请为每个环境分别安装 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 会运行该插件的会话启动钩子，因此 Superpowers 从第一条消息起就会生效。使用相同命令重新安装即可更新。

Codex App

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

在 Codex 应用中，点击侧边栏的 Plugins。你应该会在 Coding 部分看到 Superpowers。点击 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

从此仓库以 Pi 包的形式安装 Superpowers：

pi install git:github.com/obra/superpowers

对于本地开发，以临时包的形式加载此检出目录来运行 Pi：

pi -e /path/to/superpowers

Pi 包会加载 Superpowers 技能以及一个小型扩展，该扩展会在会话启动时以及压缩后注入 using-superpowers 引导程序。Pi 原生支持技能，因此不需要兼容性 Skill 工具。子智能体和任务列表工具仍是可选的 Pi 配套包。

Hermes Agent

从此仓库以 Hermes 插件形式安装 Superpowers：

hermes plugins install obra/superpowers --enable

安装后重启所有活跃的 Hermes 会话。

注意：Hermes 没有压缩后钩子，因此如果某个超长会话在第一轮之后发生压缩，就会丢失引导程序——如果技能停止触发，请启动一个新会话。

基本工作流程

• brainstorming - 在编写代码之前激活。通过提问来打磨粗略的想法，探索替代方案，分段展示设计以供验证。保存设计文档。
• using-git-worktrees - 在设计获批后激活。创建