技能框架 Superpowers 实测:Claude Code 七步工作流详解

简介: Superpowers 是一套强制执行的AI编程方法论框架,将TDD、需求梳理、代码评审等15项工程实践拆解为可插拔技能,自动注入Claude Code等16款主流AI工具。MIT开源,v7.0.2版已获32万+ Star。(239字)

技能框架 Superpowers 实测

用 AI 编程助手写代码久了,几乎每个开发者都会撞上同一堵墙:你说想加个功能,它抄起键盘就开写——不问需求细节、不写测试、改完还宣称"已完成"。GitHub 上的开源项目 Superpowers 专门治这个毛病:它不是又一个提示词合集,而是一整套强制执行的开发方法论。项目由 Jesse Vincent(obra)于 2025 年 10 月开源,截至本文写作已收获 32 万+ Star、2.8 万 Fork,最新版本 v7.0.2 于 2026 年 11 月更新,MIT 协议,支持 Claude Code、Codex、Cursor、Gemini CLI 等 16 款主流 AI 编程工具。

下载地址(仓库源码打包):https://pan.quark.cn/s/98137ef58988

仓库地址:github.com/obra/superpowers

下面结合仓库源码与官方文档,把这套框架的机制、七步工作流和全平台安装方法一次讲清。

一、Superpowers 是什么:给 AI 助手装上"工程方法论"

Superpowers 官方对自己的定位是:"An agentic skills framework & software development methodology that works"——一套可用的智能体技能框架和软件开发方法论。

它解决的核心问题是:大模型编程助手默认是"被动问答"模式,缺乏资深工程师的工作习惯。你让它做个功能,它不会先问"你到底要解决什么问题",不会先写失败测试,也不会在改完代码后自我审查。Superpowers 把这些习惯拆成了 15 个独立技能,并通过启动钩子在每次会话开始时自动注入,让 AI 在干活前先"想起来"该按什么流程干。

几个关键数据先摆出来:

  • Star 数:32 万+(发布一年出头,日均增长数百)
  • 技能数量:15 个核心技能,覆盖测试、调试、协作、元技能四大类
  • 宿主支持:16 款 AI 编程工具,包括 Claude Code、Codex App/CLI、Cursor、Gemini CLI、GitHub Copilot CLI、Qwen Code、Kimi Code、Devin CLI、OpenCode、Pi、Muse、Antigravity、Factory Droid、Grok Build CLI、Hermes Agent
  • 协议:MIT,可自由商用和二次修改
  • 语言构成:以 Shell 脚本和 Markdown 技能文件为主,不引入额外运行时依赖

从仓库首页可以看到,项目为每个宿主单独维护了插件目录(.claude-plugin、.codex-plugin、.cursor-plugin、.devin-plugin、.kimi-plugin、.muse-plugin 等),版本统一在 v7.0.2,说明作者对"同一套技能、所有工具通用"这一点做了认真的适配,而不是只在 Claude Code 上可用。

二、核心机制:技能即文件,触发即流程

理解 Superpowers 的关键是它的"技能即文件"设计。每个技能就是一个 SKILL.md 文件,由两部分组成:

  1. YAML frontmatter:声明技能名称和描述,用于让 AI 判断"当前任务是否命中这个技能";
  2. 正文指令:该技能的完整执行步骤、检查清单和禁忌事项。

例如 test-driven-development 技能的正文会明确规定:先写失败测试、观察它失败、写最少代码让它通过、再提交;writing-plans 技能会要求把任务拆成 2-5 分钟的小块,每块附带精确的文件路径、完整代码和验证步骤。

技能的加载方式决定了它的资源效率:AI 助手平时只持有全部技能的"描述索引"(很小的上下文开销),只有当任务匹配到某个技能时,才把对应的 SKILL.md 全文载入上下文。这比往系统提示词里塞一整套流程模板要省得多,也更不容易让模型分心。

另一个重要机制是 SessionStart 启动钩子:在 Claude Code、Codex、Cursor、Gemini CLI、Pi 等宿主上,框架通过会话启动钩子自动注入 using-superpowers 技能,相当于每次开机都给 AI 念一遍"工作守则"。你不需要在每轮对话里手动喊"请遵守 TDD",流程是自动生效的。

三、七步工作流:从"听需求"到"合代码"

Superpowers 七步工作流

这是 Superpowers 的灵魂部分。官方 README 把它称为 "The Basic Workflow",七步环环相扣,而且 README 末尾专门强调了一句:The agent checks for relevant skills before any task. Mandatory workflows, not suggestions.(AI 在每个任务前都会检查相关技能——这是强制流程,不是建议。)

第 1 步:brainstorming(需求梳理)。 在写任何代码之前触发。技能会通过提问引导你说清楚"你真正想要什么、为什么要做",然后把它理解的内容复述给你纠错。小改动直接在对话里确认即可;成规模的项目会沉淀出一份书面设计文档,标准是"一个不了解项目上下文的执行者能照着做计划"。

第 2 步:using-git-worktrees(隔离工作区)。 设计确认后触发。在新分支上创建独立的 git worktree 工作区,运行项目初始化,并验证测试基线是干净的。这一步保证后续的改动不会污染你的主工作区。

第 3 步:writing-plans(任务拆解)。 把工作拆成每个 2-5 分钟的小任务,每个任务写明精确的文件路径、完整代码和验证步骤。拆解粒度的标准很直白:一个"热情但品味差、没有项目上下文、不爱写测试的初级工程师"也要能照着执行。

第 4 步:subagent-driven-development 或 executing-plans(执行)。 两条路线二选一:前者给每个任务派发一个全新的子代理,做完即审查,最彻底;后者在当前会话内逐任务内联执行,最后对整个分支做一次完整审查,最省 token。框架还配套 dispatching-parallel-agents 技能支持并发子代理。

第 5 步:test-driven-development(TDD 红绿循环)。 实现阶段强制生效:先写失败测试 → 观察失败 → 写最小实现 → 观察通过 → 提交。技能里甚至写明:发现先于测试写出的代码,直接删掉重写。

第 6 步:requesting-code-review(代码评审)。 任务之间触发,按计划逐条对照检查,按严重程度汇报问题,关键问题会阻断后续进度。配合 receiving-code-review 技能,AI 还能正确地响应评审意见而不是敷衍了事。

第 7 步:finishing-a-development-branch(分支收尾)。 任务全部完成后触发:再次验证测试,给出合并/提 PR/保留/丢弃四个选项,并清理 worktree。

实际体验下来,这套流程最大的价值是把"AI 干活不可预期"变成了"AI 干活有账可查":每一步的产出(设计文档、任务清单、测试记录、评审意见)都是落盘的文件,出问题时可以逐级回溯。

四、15 个核心技能全景

除七步工作流外,仓库 skills/ 目录下还有调试和元技能,按用途分成四类:

分类 技能 作用
测试 test-driven-development RED-GREEN-REFACTOR 循环,附测试反模式清单
调试 systematic-debugging 四阶段根因定位(含条件等待、纵深防御等技巧)
调试 verification-before-completion 宣称"修好了"之前先验证确实修好了
调试 diagnosing-superpowers 排查会话里 Superpowers 自身的异常
协作 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 技能系统入口,会话启动时注入

值得单独一提的是 systematic-debugging:它要求 AI 排查 bug 时走"复现 → 定位根因 → 修复 → 验证"四阶段,禁止"改一行试试看"的盲改。以及 diagnosing-superpowers,当某个技能该触发却没触发、或 AI 无视计划重复劳动时,你可以直接对助手说"figure out what went wrong with superpowers in this session",它会读取会话记录、给出带行号证据的分析报告,还能打包一份脱敏的 bug 报告。

五、16 款 AI 编程工具的安装方法

Superpowers 对每个宿主的安装方式都做了适配,下面按工具分列,命令都来自官方 README,可直接使用。

1. Claude Code(最简单,官方插件市场一条命令):

/plugin install superpowers@claude-plugins-official

也可以走作者维护的第三方市场:

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

2. Codex App / Codex CLI(OpenAI 官方插件市场): App 版在侧边栏 Plugins 的 Coding 分区里找到 Superpowers 点"+"安装;CLI 版输入 /plugins 后搜索 superpowers,选 Install Plugin。

3. Cursor(插件市场): 在 Agent 聊天里输入:

/add-plugin superpowers

4. Gemini CLI(扩展安装):

gemini extensions install https://github.com/obra/superpowers

5. Qwen Code(直接兼容 Claude Code 市场):

qwen extensions install obra/superpowers

6. GitHub Copilot CLI:

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

7. 其余九款工具的命令速查:

工具 安装命令
Devin CLI devin plugins install obra/superpowers
Factory Droid droid plugin marketplace add https://github.com/obra/superpowers 后 droid plugin install superpowers@superpowers
Grok Build CLI grok plugin install superpowers@xai-official --trust
Kimi Code /plugins 菜单进入 Marketplace 安装,或 /plugins install https://github.com/obra/superpowers
OpenCode 让助手读取并执行官方 .opencode/INSTALL.md 中的说明
Antigravity agy plugin install https://github.com/obra/superpowers
Pi pi install git:github.com/obra/superpowers
Hermes Agent hermes plugins install obra/superpowers --enable
Muse muse plugins install ./superpowers 后 muse plugins approve superpowers

注意两点:如果你同时使用多款工具,需要每款工具单独安装一次,技能状态互不共享;首次安装时宿主会请求批准 SessionStart 钩子,记得点允许,否则技能不会自动注入。

六、装完之后:验证与排错

验证是否装好的最直接方法:开一个全新会话,对助手说 Let's make a react todo list。如果安装正常,它在写第一行代码前会先自动进入 brainstorming 技能,开始向你确认需求——这就是框架生效的标志。如果它直接开始写代码,说明技能没有触发。

常见问题排查:

  1. 技能不触发:先确认安装时是否批准了 SessionStart 钩子(部分宿主如 Muse 首次安装需要 approve);然后重启会话再试。
  2. 长会话后技能失效:Hermes Agent 没有会话压缩后的钩子,长会话一旦触发上下文压缩,启动注入的守则会丢失——直接开新会话即可。Claude Code 等主流宿主会在压缩后重新注入,一般不受影响。
  3. 行为异常/重复劳动/烧 token:直接对助手说 "figure out what went wrong with superpowers in this session",调用 diagnosing-superpowers 技能自助排查。
  4. 更新:多数宿主的更新是自动的;手动更新的话,Gemini 用 gemini extensions update superpowers,Devin 用 devin plugins update superpowers,Muse 用 muse plugins update superpowers。

七、适用场景与局限性

适合用的场景:功能开发(新模块、新页面、新接口)、重构(TDD 保护下的安全重构)、团队需要统一 AI 编程规范、希望 AI 能长时间自主干活(子代理模式下它可以按计划连续工作一两个小时不跑偏)。

需要权衡的地方:

  1. 小改动会被"流程拖累":brainstorming 对一行小修也可能触发,虽然支持在对话里快速确认,但如果你只想要"改完即走"的体验,会觉得仪式感偏重。好在技能允许小变更走轻量路径。
  2. 多代理执行消耗 token:subagent-driven-development 路线每个任务都起子代理并审查,token 开销明显高于单会话模式;预算敏感可以用 executing-plans 路线。
  3. 贡献门槛较高:官方明确表示不接受新增技能的随意贡献,技能改动必须兼容全部 16 个宿主,并有专门的评测套件把关——对普通用户是好事(质量稳定),对想深度定制的开发者是限制。
  4. 企业支持收费:个人使用零成本(MIT 开源),企业级支持、附加工具和托管额度需要联系官方商业团队。

八、总结

Superpowers 的价值不在于"多给了 AI 几个工具",而在于把一套被验证过的软件工程方法论(需求先行、TDD、子代理协作、强制评审)做成了 AI 助手的默认行为。32 万 Star 的热度背后,是"AI 编程从玩具走向工程"这个真实需求。如果你每天用 Claude Code 或其他 AI 编程工具干活,值得花十分钟装上试一次——尤其是那个"开新会话说 make a react todo list"的验证方式,装没装好一试便知。

FAQ

Q1:Superpowers 和直接往系统提示词里写工作流有什么区别?

三个区别:一是按需加载,技能文件只在命中时载入,不占用常驻上下文;二是触发可靠,SessionStart 钩子每次会话自动注入,不依赖你手动强调;三是可维护,每个技能独立成文件、有版本管理,可以单独更新而不动其他配置。

Q2:不使用 Claude Code 也能用吗?

能。16 款宿主共用同一套技能源,Claude Code、Codex、Cursor、Gemini CLI、Qwen Code、Kimi Code、Copilot CLI 等都有一等支持,第五节有完整命令表。

Q3:需要付费吗?

MIT 协议开源,个人和商业项目均可自由使用,无需付费;仅企业级支持服务收费。

Q4:技能改坏了怎么恢复?

通过宿主的插件机制重装即可覆盖(Gemini/Qwen/Devin/Muse 均有 update 命令);如果怀疑是技能本身的问题,用 diagnosing-superpowers 技能先定位,再决定是否回退或到仓库 issues 页反馈。


更多安装细节与文档见仓库 README:https://github.com/obra/superpowers

相关文章
|
8天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
9109 24
|
8天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2699 14
|
3天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1287 0
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
6天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
10天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
10天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
23天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
11127 59
|
3天前
|
人工智能 弹性计算 IDE
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
适合团队落地代码规范,每次提交自动生成评审报告,降低人工CR工作量。同时支持自定义技能脚本,接入团队内部SDK说明文档,让Codex生成符合团队编码规范的代码。Codex三大客户端覆盖本地开发、服务器远程编码、自动化流水线场景,搭配阿里云百炼的Token Plan、Coding Plan,能够低成本搭建稳定可控的AI编码助手。新手建议先从IDE插件入手,熟悉交互逻辑,再尝试CLI版本部署在阿里云ECS,实现云上项目远程编码、批量脚本处理。只要按照步骤完成环境准备、版本选型、密钥对接、项目初始化,就可以把Codex融入日常开发流程,大幅提升代码编写、问题排查、项目重构的效率。
944 0
|
6天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1319 1
|
9天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。