跳到正文
阿里雲開發者社區 AI·· 14 小時前AI 評分71

Superpowers 技能框架實測:Claude Code 七步工作流程詳解

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

AI 導讀

Superpowers 是一套面向 Claude Code 等 16 款 AI 編碼工具的開源智能體技能框架,文章詳解其七步開發流程。流程涵蓋需求梳理、隔離工作區、任務拆解、TDD、程式碼評審及分支收尾,並整理多款工具的安裝與排錯方法。

正文

简介: 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

來源:阿里雲開發者社區 AI · developer.aliyun.com