Superpowers:5分钟给AI编程助手装上一套完整的开发流程
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一款面向 AI 编程助手的技能库与开发方法论。装好之后,你的 Agent 接到任务不会直接冲去写代码,而是先问清你到底想做什么,再按设计、规划、编码、审查一步步推进。本文讲清楚它是什么、如何 5 分钟内装好、以及它每个环节具体帮你做什么。
一句话搞懂 Superpowers 是什么
如果 AI 编程助手是个干活利索但没经验的年轻人,Superpowers 就是旁边那位较真的老工程师:写代码的仍是 AI,负责盯着它别跑偏的是这套技能库。
它解决的是流程问题:需求聊不清楚就动手、不写测试先堆代码、修 Bug 靠猜。
它不解决这些:不能让你的 IDE 变快,不能替代编译器,也不会让模型本身变聪明。模型能力决定下限,Superpowers 决定这个下限会不会被乱流程浪费掉。
最短上手路径:3 步装好
以最常用的 Claude Code 为例,全程只需在终端里敲两条命令:
打开 Claude Code,运行下面这段注册市场并安装插件的命令:
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace装完后三步走:
- 重启 Claude Code,新开一个会话
- 随便提一个需求,比如"帮我写个记账小工具"
- 观察它开始提问而不是贴代码——说明技能已自动加载
技能是自动触发的,不需要你手动调用,也不需要写任何配置文件。
技能什么时候触发:按场景看
brainstorming(头脑风暴)—— 当你脑子里只有一个模糊想法时。它一次只问一个问题,把需求逼问清楚,给出 2-3 个带取舍的方案,你确认后把设计文档落盘。设计没过你的目,任何实现类技能都不许动。
writing-plans + subagent-driven-development(规划与子代理开发)—— 当你准备动手写代码时。前者把工作拆成 2-5 分钟一个的小任务,每个任务写清文件路径和验证方式;后者为每个任务派一个全新子代理执行,做完先查"是否符合规范",再查"代码质量如何",两关都过才继续。
test-driven-development(测试驱动开发)—— 当开始实现功能时。它强制执行红-绿-重构循环:先写会失败的测试,看它失败,再写最少的代码让它通过。先写代码后补测试?那段代码会被要求删掉重写。
systematic-debugging(系统化调试)—— 当你被 Bug 卡住时。分四个阶段:先查根因,再谈修复。没完成根因调查前,连"我觉得加个 try-catch 就行"这种猜测都不许出现。越是"改一下就完事"的场景,它拦得越死。
verification-before-completion + requesting-code-review(完成前验证与代码审查)—— 当你以为做完了的时候。前者要求拿证据说话,测试没跑过不许宣布完成;后者在任务之间对照计划审查代码,问题按严重程度分级,严重问题会直接卡住后续进度。
从想法到交付:一条完整链路
把一个模糊想法变成可合并的分支,典型路径是 6 步:
- brainstorming:提问、给方案、产出设计文档
- using-git-worktrees:开独立工作区和分支,跑一遍测试确认基线是绿的
- writing-plans:把设计拆成带验收标准的小任务
- subagent-driven-development:逐任务派子代理执行,两阶段审查
- requesting-code-review:任务之间按严重程度报告问题
- finishing-a-development-branch:验证测试,给出合并、提 PR 或丢弃的选项并清理现场
整个过程里,Agent 可能在第 4 步连续自主工作几个小时而不出轨,因为每一步的轨道是前面几步定好的。
其他平台怎么装:差异对照
不同客户端要分别安装,装过一个不代表全都能用。
| 平台 | 安装方式 | 更新方式 |
|---|---|---|
| Claude Code | 上面两条/plugin命令 | 重装或自动更新 |
| Codex | 应用内 Plugins 面板或 CLI 里搜 superpowers | 重装 |
| OpenCode | 按官方指引克隆仓库到配置目录并建软链 | 目录内git pull |
| Gemini CLI | gemini extensions install一条命令 | gemini extensions update superpowers |
以 OpenCode 为例,克隆这一步的命令是:
git clone https://gitcode.com/GitHub_Trending/su/superpowers ~/.config/opencode/superpowers之后更新也就是进目录拉一下:
cd ~/.config/opencode/superpowers git pull常见报错与高频问题
问:装好了,Agent 还是上来就写代码?每个客户端都要单独装一次,装完要重启才生效。只装了 Claude Code 的话,Codex 和 OpenCode 里的它依然是"裸"的。
问:它会往外发我的项目数据吗?brainstorming 的可选可视化伴侣功能会从官网加载一个 logo,只带版本号,不带项目内容、提示词或任何你点了什么的记录。介意可以设置环境变量SUPERPOWERS_DISABLE_TELEMETRY完全关掉。
问:技能太多会不会拖慢对话?技能是按场景条件触发的,平时安静待命。真正吃时间的是它要求的流程本身(比如强制 TDD),这是用一点速度换可预期的质量,属于设计上就要付出的成本。
适合谁,不适合谁
适合:每天用 AI 编程助手干活、受够了结果质量忽高忽低的人,以及想统一团队 AI 开发流程的团队。
不适合:只是偶尔问一句"这个报错什么意思"的轻量用户,流程对你来说是负资产。它也救不了底层模型太弱的情况——流程保证不跑偏,但不保证跑得飞快。
进阶:把自己的流程做成技能
如果你有一套团队反复执行的操作(比如提交信息规范、部署前检查清单),可以用技能库自带的writing-skills技能把它打包成新技能。写好后它会和内置技能一样被自动触发,相当于给 Superpowers 装上只属于你团队的插件。
现在就试
如果你已经在用 Claude Code,打开终端把上面那两条命令敲下去,然后在下一个需求里观察它:是开始提问,还是照旧直接贴代码。答案会替你省掉这篇文章剩下的所有判断。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考