cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

技能

Superpowers

Jesse Vincent 的技能框架,让编码代理先计划、先写测试,再改代码。

Superpowers 是 obra(Jesse Vincent)维护的一套代理技能和开发方法。它把常见的软件工作拆开:先把设计说清楚,写计划,先写测试,再让代理实现,最后做复查。仓库用 MIT 许可发布。

适合已经在用 Claude Code、Cursor 或 Codex、但不希望代理一上来就改文件的人。按仓库里的安装说明启用,然后拿一个很小的任务看它会不会先停下来做计划。

本页是导读,不是原文。

注意(核验日期 2026-11-15):仓库未归档,最新发版为 v7.0.2(2026-11-04 06:17 Asia/Shanghai)。Claude Code 的当前安装方式是官方插件市场命令 /plugin install superpowers@claude-plugins-official(https://claude.com/plugins/superpowers),这个项目并没有被官方技能机制取代。已知它与 Claude Code 的工具变化存在冲突,例如 issue #2177、#2699、#2701。2026-11-08 仍有帖文使用旧命令 npx skills add obra/superpowers。

解决什么问题

obra/superpowers 是 Jesse Vincent(obra)维护的一套代理技能和开发方法。它希望编码代理在动手改文件之前,先把需求和设计问清楚,写出可执行的计划,再按测试驱动的方式实现,并在任务之间做复查。仓库用 MIT 许可发布,并未归档。

核验日期为 2026-11-16(Asia/Shanghai)。GitHub Releases 的最新正式版是 v7.0.2,发布时间是 2026-11-03 22:17 UTC,换算为 2026-11-04 06:17(Asia/Shanghai)。仓库最近一次推送是 2026-11-04 07:24(Asia/Shanghai)。本站已把它移出首页要目并加了警告提示,原因是安装方式已经变化,并且它与部分编码工具存在已知摩擦,而不是项目停止维护。它也没有被 Anthropic 的官方 Agent Skills 机制取代:Claude Code 仍可通过官方插件市场安装。

适合谁

适合已经在使用 Claude Code、Cursor、Codex 或其他 README 列出的编码工具,又不希望代理一上来就改代码的人。官方流程强调先讨论设计、再写计划、再实现,因此不适合「只想立刻改一个文件」的短任务。

README 为多种工具分别写了安装方式,并提醒:若你同时使用不止一种工具,需要分别安装。本指南重点写 Claude Code、Cursor 和 Codex CLI 的官方命令;其他工具请直接看仓库 README,不要把某一家的命令套到另一家。

怎么装

命令来自 2026-11-16 查阅的仓库 README。不要再使用仍在流传的旧命令 npx skills add obra/superpowers。

Claude Code

官方推荐路径是 Anthropic 的官方插件市场:

/plugin install superpowers@claude-plugins-official

也可以先登记 Superpowers 自己的市场,再安装:

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

Cursor

在 Cursor 的 Agent 对话里执行:

/add-plugin superpowers

也可以在插件市场里搜索 “superpowers”。

Codex CLI

官方说明走 OpenAI 的插件市场。先打开插件搜索界面:

/plugins

再搜索 superpowers,选择 Install Plugin。Codex 应用则是在侧栏 Plugins 的 Coding 分类里添加 Superpowers。

装好后,用一个很小、可丢弃的任务看它会不会先停下来讨论设计,而不是立刻写文件。更新方式因工具而异,README 只概括说「常常是自动的」,没有给出适用于所有工具的统一升级命令。

一个实际例子

官方在 Muse 安装说明里,把「新开一轮对话,发送 Let's make a react todo list」当作安装是否生效的检查:正常情况下应先触发 brainstorming,而不是直接写代码。本次没有在本机实跑,因此不编造它会问哪些问题,也不编造生成的设计文档。

  1. 按你实际使用的工具,用上一节的官方命令安装,不要混用旧的 npx 命令。
  2. 新开一轮对话,在一个空的练习目录里发送上述提示,或改成你自己的、范围同样小的练习任务。
  3. 预期效果(来自官方说明,不是实测):代理应先把设计说清楚并征求确认,而不是马上创建项目文件。
  4. 若它直接开始改文件,先不要继续扩大任务。可按 README 的建议,让它「figure out what went wrong with superpowers in this session」,并自己审查后续 diff。

常见坑

  • 仍按旧教程执行 npx skills add obra/superpowers。2026-11-16 的 README 对 Claude Code 给出的是 /plugin install 命令。
  • 把「已进入官方市场」理解成「和当前 Claude Code 完全没有摩擦」。issue #2177 在 2026-11-16 仍为开放(open),最近更新时间是 2026-10-22 20:00 UTC,即 2026-10-23 04:00(Asia/Shanghai)。它报告:从 Claude Code 2.1.233 起,部分当前模型不再默认提供 TodoWrite / Task* 工具,而当时的 Superpowers 技能仍要求使用这些工具;报告环境是 Superpowers 6.3.0 与 Claude Code 2.1.235。issue 中的权宜做法是在 ~/.claude/settings.json 的 env 里设置 CLAUDE_CODE_ENABLE_TODO_TOOLS 为 "1"。此后已发布 v7.0.2,本次没有复测该问题在 7.0.2 上是否仍然存在,不能把它写成已经修复或一定仍会复现。
  • issue #2699 在 2026-11-16 仍为开放,创建于 2026-11-14 19:58(Asia/Shanghai)。它针对 v7.0.2,认为 using-superpowers 里偏强硬的措辞会让当前 Claude 模型过度触发技能。这是用户报告,不是官方已确认的结论。
  • 若你使用 OpenCode:issue #2701 在 2026-11-16 仍为开放,创建于 2026-11-14 20:46(Asia/Shanghai)。它认为插件在 OpenCode v2 的工具映射里错误宣称「没有 todo 工具」,与 experimental.todo 开启后实际存在的 todowrite 不符。本次没有在 OpenCode 上复现。
  • 可选的可视化配套功能默认会从维护方网站加载 Logo,并带上 Superpowers 版本号。官方说明这不包含项目、提示词或所用工具的细节,并可用环境变量 SUPERPOWERS_DISABLE_TELEMETRY 关闭;同时尊重 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC。

FAQ

Superpowers 是不是已经被官方 Agent Skills 取代了?

没有。2026-11-16 查阅的仓库 README 仍把 Claude Code 的安装路径指向官方插件市场命令 /plugin install superpowers@claude-plugins-official,并链接 claude.com/plugins/superpowers。本站把它移出要目,是因为安装说明容易过时、以及存在上述开放 issue,不是因为它已被官方机制替代。

Claude Code 现在应该用哪条安装命令?

以仓库当前 README 为准:/plugin install superpowers@claude-plugins-official。不要把旧的 npx skills add obra/superpowers 当成当前官方命令。

最新版本是哪一个?

GitHub Releases 在 2026-11-16 显示的最新正式版是 v7.0.2,发布于 2026-11-04 06:17(Asia/Shanghai)。若你本地看到的版本不同,先对照该 Releases 页面,而不是只看第三方教程。

为什么代理说找不到 TodoWrite 或 Task 工具?

issue #2177(仍开放)描述过这类情况,并给出了环境变量权宜做法。该 issue 针对的是 6.3.0 和当时的 Claude Code 版本。v7.0.2 发布之后,本次没有复测,因此不能保证同一设置仍然必要,或问题已经消失。请先看该 issue 的当前讨论和官方 README。

许可证是什么?可以商用吗?

仓库声明为 MIT License,详见 LICENSE。商用或再分发前请自行阅读许可全文。README 另外提到企业支持可联系 [email protected],这与开源许可是分开的,本文不讨论商务条款。

来源与许可

仓库 obra/superpowers 使用 MIT 许可。本文依据 2026-11-16 查阅的 README、v7.0.2 发版说明、官方插件页,以及当时仍为开放的 issue #2177、#2699、#2701,用自己的话写成,供 CQBase 上下文库使用。若安装命令或已知问题有变,以仓库和官方插件页为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。