跳到正文
原文
web-github-trending ·· 17 天前精选AI 评分76

Superpowers：面向编码智能体的软件开发方法论技能包

obra / superpowers

AI 导读

Superpowers 是一套面向编码智能体的软件开发方法论，由一组可组合的技能和初始指令构成，让智能体在写代码前先梳理需求、产出设计文档和实现计划，再以子智能体驱动的方式逐任务开发并审查。

推荐理由

一套面向编码智能体的开发方法论技能包，覆盖头脑风暴到分支收尾的完整流程，支持多种主流编码工具。

正文 · AI 翻译

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

目录

工作原理

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

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

在你确认设计之后，你的智能体会整理出一份实现计划，清晰到足以让一位热情高涨但品味欠佳、缺乏判断力、没有项目背景、还讨厌测试的初级工程师照着执行。它强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY。

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

还有更多内容，但这就是该系统的核心。而且由于这些技能会自动触发，你不需要做任何特别的事情。你的编码智能体天生就拥有 Superpowers。

商业服务

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

安装

安装方式因运行环境而异。如果你使用多个环境，请为每个环境分别安装 Superpowers。

Claude Code

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

官方市场

  • 从 Anthropic 的官方市场安装该插件：

    /plugin install superpowers@claude-plugins-official

Superpowers 市场

Superpowers 市场为 Claude Code 提供 Superpowers 以及其他一些相关插件。

  • 注册该市场：

    /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

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

pi install git:github.com/obra/superpowers

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

pi -e /path/to/superpowers

Pi 包会加载 Superpowers 技能以及一个小型扩展，该扩展会在会话启动时以及压缩后再次注入 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——正常安装会在编写任何代码之前自动触发 brainstorming。版本记录在 .version-bump.json 中，因此 scripts/bump-version.sh 会使其保持同步。

基本工作流程

  1. brainstorming - 在编写代码之前激活。通过提问完善粗略想法，探索替代方案，分节呈现设计以供验证。保存设计文档。

  2. using-git-worktrees - 在设计获批后激活。在新分支上创建隔离工作区，运行项目设置，验证干净的测试基线。

  3. writing-plans - 在设计获批后激活。将工作拆分为小任务（每个 2-5 分钟）。每个任务都有确切的文件路径、完整代码和验证步骤。

  4. subagent-driven-development 或 executing-plans - 在计划就绪后激活。要么为每个任务派发一个新的子代理并在每次之后进行审查（最彻底），要么在当前会话中内联实现每个任务，并在最后对整个分支进行一次全新审查（最经济）。

  5. test-driven-development - 在实现期间激活。强制执行 RED-GREEN-REFACTOR：编写失败的测试，观察其失败，编写最小代码，观察其通过，提交。删除在测试之前编写的代码。

  6. requesting-code-review - 在任务之间激活。对照计划进行审查，按严重程度报告问题。关键问题会阻碍进展。

  7. finishing-a-development-branch - 在任务完成时激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作树。

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

出问题时

有时会话会表现异常：技能在不该触发时触发，在该触发时保持沉默，或者智能体忽略其计划、重复工作，或消耗比你预期更多的 token。让你的编码智能体“弄清楚这次会话中 superpowers 出了什么问题”，它就会调用 diagnosing-superpowers 技能。要检查更早的会话，请指明它：“弄清楚会话 <id> 中 superpowers 出了什么问题”。

该技能会读取会话记录，以行级证据报告发生了什么，并且如果你愿意，还可以打包一个经过清理的捆绑包用于错误报告。

社区

Superpowers 由 Jesse Vincent 以及 Prime Radiant 的其他成员构建。

内容概览

技能库

测试

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

调试

  • systematic-debugging - 4 阶段根因流程（包含根因追踪、纵深防御、基于条件的等待技术）
  • 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 的一般贡献流程。请记住，我们通常不接受新技能的贡献，并且对技能的任何更新都必须在我们支持的所有编码智能体中可用。

  1. 复刻仓库
  2. 切换到 'dev' 分支
  3. 为你的工作创建一个分支
  4. 按照 writing-skills 技能来创建和测试新增及修改的技能
  5. 提交 PR，务必填写 pull request 模板。

技能行为测试使用来自 superpowers-evals 的 drill eval harness，克隆到 evals/ —— 设置方法见 evals/README.md。插件基础设施测试位于 tests/，通过相关的 run-*.sh 或 npm test 运行。

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

更新

Superpowers 的更新在一定程度上取决于编码代理，但通常是自动的。

许可证

MIT 许可证 - 详情见 LICENSE 文件

视觉伴侣遥测

由于技能和插件不会向创建者提供任何反馈，我们无从得知你们中有多少人在使用 Superpowers。默认情况下，头脑风暴可选视觉伴侣功能上的 Prime Radiant 标志是从我们的网站加载的。其中包含正在使用的 Superpowers 版本。它不包含任何关于你的项目、提示词或编码代理的详细信息。我们看不到你的点击，也看不到任何关于你在构建什么的内容。这有助于我们大致了解有多少人在使用 Superpowers 以及他们使用的是哪个版本。这 100% 是可选的。要禁用此功能，请将环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设置为任意真值。Superpowers 也遵循 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出选项。

来源：web-github-trending · github.com

#工具/插件#编码#Agent#开源/仓库