RepoDaily · 2026-07-01 · Infrastructure / Runtime

Superpowers:把编码 Agent 变成守纪律工程师的技能框架

#6 Infrastructure / Runtime Shell +884 obra/superpowers 打开仓库

Superpowers(v6.1.0,MIT 许可)以 Shell 插件形式为 Claude Code、Cursor、Codex 等十种 Agent 安装“先规格、后计划、再 TDD”的完整开发方法论。

项目类型Infrastructure / Runtime
最适合使用 Claude Code、Cursor、Codex 等 AI 编码 Agent,希望 Agent 先规划、写规格、做测试,而不是一上来就堆代码的开发者。
风险等级中等——它会改变 Agent 在你仓库中的行为方式,需要你信任并审查自动触发的技能。
评估时间30 到 60 分钟即可在一个 Agent 平台上完成安装,并跑通一个“规格→计划→实现”的小功能。

核心问题: 你是否能接受 Agent 在产出代码之前,先花时间做规格澄清和子 Agent 驱动的计划?

90/100

RepoDaily 采用评分

RepoDaily 将该项目的采用分评为 90/100(强):分数来自文章来源、安装路径、生产风险、差异化、许可证清晰度以及 AI/Agent 适配度。

基于 RepoDaily 来源和采用说明的方向性评分,不是基准测试。风险: 中
100证据质量

包含 4 个来源、覆盖 4 类来源;如有 RepoDaily 独有模块,会进一步提高证据分。

93可安装/可试用性

检测到 7 个工作流步骤、5 个下一步动作,以及 0 个命令/安装信号。

67维护可信度

趋势热度为 +884 stars;如内容中有 release、issue 或维护信号,会提高维护可信度。

90生产准备度

采纳风险标记为 medium,并包含 4 条安全说明与 4 条跳过条件。

100差异化

3 个机会视角、4 个替代方案,以及 4 个类型化模块支撑差异化判断。

82许可证清晰度

文章中包含许可证来源或许可证表述。

90Agent / AI 适配度

文章正文和元数据中检测到 7 个 AI/Agent 相关信号。

项目概览

Superpowers 是由 Jesse Vincent 创建的基于 Shell 的 Agent 技能框架与软件开发方法论。当前版本 6.1.0 以 MIT 许可发布,安装到已有的编码 Agent 平台中——它本身不是独立的模型或编辑器。安装后,它会接管 Agent 的执行流程:Agent 不再立刻写代码,而是先问你到底想做什么,再以可审阅的小段形式给出规格,随后生成实现计划,最后通过子 Agent 驱动的过程开始编码。

项目区别于普通提示词片段的地方在于,它打包了可组合的技能和 session-start 钩子。技能会自动触发,开发者无需每次手动调用某个斜杠命令。README 明确说明,Agent 可以在不偏离计划的前提下连续自主工作数小时。

支持面很广:Quickstart 列出了 Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode 和 Pi 共十个平台。每个平台的安装方式不同,若同时使用多个平台需要分别安装。package.json 表明项目是 ES 模块(`"type": "module"`),主入口为 `.opencode/plugins/superpowers.js`,Pi 扩展位于 `./.pi/extensions/superpowers.ts`,技能目录位于 `./skills`。

商业层面由 PrimeRadiant 提供,面向企业用户提供商业支持、额外工具和托管计费(sales@primeradiant.com)。README 还宣布正在招聘全职社区工程师,说明项目有持续维护意图,而非一次性实验。

解决什么问题

  • AI 编码 Agent 经常不确认意图就直接写代码,导致输出浪费与实现偏差。
  • 没有强约束的方法论时,Agent 会跳过测试、忽视 DRY/YAGNI,产出难以可靠执行的计划。
  • 在不同平台(Claude Code 到 Cursor、Codex 到 OpenCode)之间切换时,自定义提示和行为往往会丢失。
  • 引入 AI Agent 的企业团队缺少一致、可审阅的开发流程,无法在初中级工程师之间复用。
  • 手工提示词工程无法跨人扩展,每个人都在重新发明“规格+计划”流程。

工作原理

  1. 使用对应平台的安装命令把 Superpowers 安装到你的 Agent 平台(例如 Claude Code 使用 `/plugin install superpowers@claude-plugins-official`,Cursor 使用 `/add-plugin superpowers`)。
  2. 当你开始会话并描述构建任务时,session-start 钩子会自动激活技能,无需手动触发。
  3. Agent 会先停下来提问,从对话中提炼出规格,而不是立刻生成代码。
  4. 规格会以短小、可审阅的小段呈现;你先确认设计,之后才会进入实现阶段。
  5. Agent 会产出一份详细到 README 描述为“品味差、没有项目上下文的热情初级工程师也能照做”的实现计划。
  6. 当你说“go”之后,子 Agent 驱动的开发流程启动:子 Agent 逐个处理工程任务,主 Agent 检查并评审其产出。
  7. 整个循环强调真正的红/绿 TDD、YAGNI 和 DRY,只要任务在已批准计划范围内,Agent 可连续自主工作数小时。

架构解读:插件引导与技能目录

package.json 把 Superpowers 声明为 ES 模块(`"type": "module"`),名称 `superpowers`,版本 `6.1.0`,`main` 指向 `.opencode/plugins/superpowers.js`。Pi 集成块引用 `./.pi/extensions/superpowers.ts` 作为扩展层,`./skills` 作为技能目录,说明可组合技能是文件系统层面的,而非硬编码在单一脚本中。

对于 Antigravity 等平台,README 说明插件会运行 session-start 钩子,因此技能从第一条消息开始就处于激活状态,使用相同的 `agy plugin install` 命令即可更新。这种基于钩子的设计让方法论对终端用户近乎透明。

package 关键字 `pi-package, skills, tdd, debugging, collaboration, workflow` 表明框架将 TDD、调试和协作视为一等技能类别,而不是事后附加到代码生成器上的补丁。

命令面:各平台安装方式一览

  • Claude Code(Anthropic 官方市场):`/plugin install superpowers@claude-plugins-official`
  • Claude Code(Superpowers 市场):`/plugin marketplace add obra/superpowers-marketplace`,再 `/plugin install superpowers@superpowers-marketplace`
  • Antigravity:`agy plugin install https://github.com/obra/superpowers`(session-start 钩子自动激活)
  • Codex CLI:打开 `/plugins`,搜索 `superpowers`,选择 `Install Plugin`
  • Cursor:在 Agent 聊天中执行 `/add-plugin superpowers`,或在插件市场搜索 'superpowers'
  • Codex App:打开 Plugins 侧栏,在 Coding 分类找到 Superpowers,点击 `+`

试用路径:30 分钟评估

选择你每天最常用的平台——Claude Code 门槛最低,因为 Superpowers 已进入 Anthropic 官方市场。执行 `/plugin install superpowers@claude-plugins-official` 并重启会话。

描述一个小而清晰的功能(例如一个输入输出明确的工具函数),观察 Agent 是否会暂停并询问规格问题,而不是直接倾倒代码。

批准规格、批准计划,再说“go”。观察子 Agent 循环是否至少执行一次红/绿 TDD 循环。如果 Agent 在实现之前先产出失败测试,说明方法论已正确安装。

维护风险与商业支持

项目由 PrimeRadiant 提供活跃的商业支持,面向企业用户提供支持、额外工具和托管计费(sales@primeradiant.com)。README 同时宣布正在招聘全职社区工程师(primeradiant.com/jobs/superpowers-community-engineer/),降低了项目被弃维护的风险。

v6.1.0 覆盖十个平台意味着维护负担较重:每个平台的插件接口都可能独立变化。采用 Superpowers 的团队应在升级前关注各平台的 changelog。

许可证为 MIT(Copyright 2025 Jesse Vincent),如果将来需要内部 fork,也没有商业使用限制。

谁适合关注

适合关注

  • 使用 Claude Code、Cursor 或 Codex 且希望强制“规格优先”行为的个人开发者与小团队
  • 希望统一团队内 AI Agent 行为方式(相同技能、相同 TDD 纪律)的技术负责人
  • 对 Agent 跳过测试、产出未审计划感到不满的开发者
  • 已经实践红/绿 TDD、YAGNI、DRY,希望 Agent 也遵守同样规则的团队
  • 能从 PrimeRadiant 商业支持层中受益的组织

可以先跳过

  • 不使用上述十个支持平台中任何一个的开发者
  • 有严格策略禁止 session-start 钩子或自动触发 Agent 技能的团队
  • 需要 Agent 立刻产出代码、不能有规格或计划步骤的项目
  • 需要独立编辑器或模型而非插件层的用户

风险与注意事项

该框架会在你的仓库中改变 Agent 的行为,在代码生成之前注入规格、计划和 TDD 步骤。风险来自行为和信任层面,而非许可层面。

  • session-start 钩子会自动激活技能,对不熟悉该方法论的团队可能造成意外
  • 子 Agent 驱动的开发可能连续自主运行数小时,需要对计划有信心并对 token 消耗进行监控
  • 十个平台意味着十条潜在升级路径,某平台插件 API 变化可能单独破坏其中一个面
  • 企业在大范围推广前应评估是否需要 PrimeRadiant 的商业支持
  • 许可证为 MIT(Copyright 2025 Jesse Vincent),无限制商业使用或修改的附加条款。
  • 插件安装来源为 obra/superpowers 或 obra/superpowers-marketplace 仓库;团队应固定并审计所安装的 commit。
  • session-start 钩子每次会话都会执行,部署前应审查钩子内容。
  • package.json 入口为 `.opencode/plugins/superpowers.js`,Pi 扩展为 `./.pi/extensions/superpowers.ts`,两者均可从文件系统读取以做安全审查。

替代方案比较

方案适用场景代价
Aider
你想要一个自带 git 工作流的独立终端编码 Agent,而不是注入到现有平台的技能层。开源
OpenHands
你需要一个自托管的自主 Agent 平台,其工具范围超出 IDE 式编码。开源
Cursor 内置 Agent 模式
你希望不安装第三方技能插件即可获得 Agent 行为,但接受没有强制规格优先循环。Cursor 订阅内含
Claude Code 原生插件
你更愿意自行组合轻量提示词和技能集,而不是采用整套方法论。随 Claude Code 免费

这个趋势说明了什么

在多平台团队中统一 AI Agent 行为

由于 Superpowers 以同一方法论安装到十个平台,同时使用 Claude Code、Cursor 和 Codex CLI 的团队可以共享同一套规格优先流程,而不必维护三套提示词。

在两个平台上安装,跑同一个功能规格,比较计划和 TDD 步骤是否一致。

通过强制规划减少 AI 生成的返工

“规格小段→计划→代码”的循环针对 AI 编码最昂贵的失败模式:大量产出偏离真实需求的代码。

在单个项目上启用 Superpowers 前后各观察两周,统计被拒 PR 或回滚 commit 数量。

通过 PrimeRadiant 走企业支持路径

PrimeRadiant 提供商业支持、额外工具和托管计费,为无法单独使用无支持开源工具的组织打开了采购友好的采纳路径。

联系 sales@primeradiant.com,确认支持范围、SLA 和价格后再决定是否大范围推广。

下一步建议

在你的主力平台上安装 Superpowers,并端到端跑通一个功能

选择你日常最常用的平台——通过 Anthropic 官方市场安装到 Claude Code 是最快路径——用默认技能把一个小功能从规格做到合入代码。

  1. 在 Claude Code 中执行 `/plugin install superpowers@claude-plugins-official`。
  2. 重启会话,通过开始一段构建任务对话确认技能已激活。
  3. 观察 Agent 是否在写代码之前先询问规格问题。
  4. 批准规格小段,批准实现计划,然后说“go”。
  5. 确认 Agent 在交付实现之前执行了一次红/绿 TDD 循环。

RepoDaily 判断

Superpowers 是本周期少有的 Shell 趋势项目——它不是 dotfile 或安装脚本,而是一套方法论运行时。它的价值在于跨十个 Agent 平台运行的强制“规格→计划→TDD”循环,可信度来自 MIT 许可、v6.1.0 的成熟度以及 PrimeRadiant 的商业支持。中等采纳风险来自行为改变和多平台维护,而非许可或安全。

信息来源