Superpowers 使用指南:给 AI 编程助手装上 14 个实用技能与标准化开发流程
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一套面向 AI 编程智能体(coding agent)的技能框架与软件开发方法论。装进 Claude Code、Cursor、Gemini CLI 等工具后,智能体不会再拿到需求就直接写代码,而是先和你确认需求、拆解方案、按测试驱动方式实现,最后再自审收尾。它本质上是把一套老练工程师的工作习惯,写成了智能体每次都会遵守的流程。
AI 编程助手默认存在的毛病:拿到需求就动手
如果你常用编程智能体,大概率遇到过这些情况:
- 你描述了一个模糊的想法,它立刻开始写代码,结果方向跑偏,改起来比重写还麻烦
- 写完的代码没有测试,或者"测试"是先看实现再补的,等于没测
- 它自称"已完成",但你一跑就发现还有问题
- 自主跑了几十分钟,产出一堆和原计划无关的东西
这些不是模型不够聪明,而是缺少流程约束。Superpowers 解决的就是这个问题:它不提供新模型,而是在智能体外层加了一套"先想清楚、再动手"的强制工作流。
Superpowers 如何重构智能体的开发流程
装好之后,一次完整的开发会自动走完下面 7 个阶段,每个阶段对应一个技能,智能体在动手前会先检查当前该用哪个技能:
| 阶段 | 对应技能 | 对你意味着什么 |
|---|---|---|
| 1. 头脑风暴 | brainstorming | 先通过提问把你的粗糙想法打磨成设计文档,分段展示供你确认 |
| 2. 建工作区 | using-git-worktrees | 在新分支上开独立工作区,并确认测试基线是干净的 |
| 3. 写计划 | writing-plans | 拆成 2~5 分钟一个的小任务,每个任务写清文件路径和验证方式 |
| 4. 执行任务 | subagent-driven-development / executing-plans | 派子智能体逐个做任务,先查是否符合规格,再查代码质量 |
| 5. 实现代码 | test-driven-development | 严格走红-绿-重构:先写失败的测试,再写最小实现 |
| 6. 代码审查 | requesting-code-review | 任务之间对照计划做审查,严重问题会阻止继续 |
| 7. 收尾分支 | finishing-a-development-branch | 验证测试后给出合并、提 PR 或丢弃的选项,清理工作区 |
这套流程的关键在于"自动触发"。你不需要记住任何指令,也不需要手动喊"用 TDD",技能会根据当前所处的阶段自己激活。官方文档里甚至用了一句很传神的话:计划要写得让"一个热情但没品味、没判断力、不爱写测试的新手工程师"也能照着执行。
技能库的 14 个技能,分别解决什么问题
skills/目录下的技能按用途可以归成四组,这里按"对新手有什么用"来介绍:
规划与协作类:brainstorming(设计阶段反复追问,避免方向跑偏)、writing-plans(把大需求拆成可验证的小任务)、executing-plans(带人工检查点的批量执行)、dispatching-parallel-agents(多个子智能体并行干活)、using-git-worktrees(用 Git 工作树隔离多个并行开发)、finishing-a-development-branch(结束时明确给出合并或放弃的选择)。
测试与调试类:test-driven-development(先测试后代码的完整循环,附反模式参考)、systematic-debugging(四阶段定位根因,附带条件等待、防御式排查等子技巧)、verification-before-completion(宣称"修好了"之前必须先验证)。
审查类:requesting-code-review(发起审查前的检查清单)和receiving-code-review(如何正确回应审查意见)。
元技能类:writing-skills(教你如何按同样标准新建一个技能)和using-superpowers(技能系统本身的入门说明)。
对普通用户来说,你不需要逐个读懂它们,只需知道:这些技能覆盖的是"从想法到合并"的完整链路,每个环节都有明确的退出标准,而不是凭感觉判断"差不多了"。
适合谁使用:三类典型场景
- 用编程智能体做真实项目的人:你希望它长时间自主工作但不跑偏,7 阶段流程就是防跑偏的缰绳
- 想改善代码质量但没时间盯每一步的人:测试先行和两级审查是自动执行的,不用你反复叮嘱
- 使用多种智能体工具的人:官方支持 Claude Code、Cursor、Gemini CLI、Codex、Kimi Code、OpenCode 等 11 种宿主环境,同一套方法论可以在不同工具间平移
如果你只是偶尔让智能体改几行代码,这套流程可能偏重;它的价值在"多步骤、需要持续迭代"的任务上才充分体现。
Superpowers 入门教程:三步完成安装与验证
第一步,获取仓库(如果你打算贡献代码或研究技能写法,先克隆下来):
git clone https://gitcode.com/GitHub_Trending/su/superpowers第二步,按你用的工具安装插件。不同宿主命令不同,挑你用的那条即可:
# Claude Code 官方市场安装 /plugin install superpowers@claude-plugins-official # Cursor 聊天窗口内执行 /add-plugin superpowers # Gemini CLI 安装扩展 gemini extensions install https://github.com/obra/superpowersCodex CLI 则在/plugins搜索界面里搜索 superpowers 并选择安装;其余工具(Antigravity、Factory Droid、Copilot CLI、Kimi Code、OpenCode、Pi)在仓库 README 的 Installation 一节都有对应命令。
第三步,验证是否生效。新开一个会话,丢一个稍微复杂的需求,比如"给项目加个导出功能"。判断标准很简单:它应该先开始追问你的目标和使用场景,而不是直接生成代码。如果它直接写码,说明技能没有挂载成功,检查安装步骤。
使用注意:先了解这 5 点
- 多工具需分别安装:如果你在 Claude Code 和 Cursor 里都用,要各自装一次,安装不共享。
- 流程是强制的,不是建议:技能触发后智能体必须走完对应流程,TDD 环节甚至会删掉你在测试之前写的实现代码——这是特性不是 bug。
- 计划粒度很细:每个任务只有 2~5 分钟的工作量,文件路径、代码、验证步骤都写死在计划里,好处是子智能体不会自由发挥,代价是前期规划时间略长。
- 遥测默认开启但完全可选:头脑风暴的可视化辅助功能会加载一个带版本号的小图标,用于统计使用人数,不含任何项目内容;不想统计的话,把环境变量
SUPERPOWERS_DISABLE_TELEMETRY设为真值即可。 - 想改流程可以看源码:技能就是
skills/下一个个带 SKILL.md 的目录,流程如何触发、如何审查,直接读对应文件就能明白,仓库还附了tests/目录和docs/testing.md说明测试方式。
装完之后,怎么判断它真的有用
不用做复杂的对比实验。挑一个你最近真正要做的小功能,全程不干预地跑一次,看三件事:有没有先给你一份可确认的设计文档;实现过程里测试是不是先于代码出现;结束时它有没有明确列出验证结果而不是口头宣布完成。三条都满足,说明这套技能库已经在按预期工作,之后就可以放心地让它长时间自主执行任务了。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考