Superpowers最佳实践指南-从零到精通的实战手册
这类的agent如果排除环境判定,权限检查,多用户架构,只要你不研究ai原理,这类无非就是在循环中添加功能,就是看你怎么添加而已。这一篇既是避坑指南,也是行动指南,我基于我的真实实践,就是历史没办法回滚。在我体验下来,目前的 AI 编程主要分为两个流派,就是说基于目标打造,然后第二个是基于强化打造,基于想法打造,那么使用一些更加自动化的插件可能会更好,但是如果你是基于功能,基于你的想法去打造,那么
上一篇文章看起来有很多人对superpower感兴趣,那就不要脸再出一篇。
这一篇既是避坑指南,也是行动指南,我基于我的真实实践,就是历史没办法回滚。(其实可以找,但是我懒,不想要找,嘻嘻)
首先教大家怎么安装。
按照常理是支持全平台的,只不过是安装的方便程度。
首先官方支持的支持 3 个平台:
- Claude Code(推荐)
- Codex
- OpenCode
这几个平台都是最方便的。
1.0 安装步骤
Claude code(通过插件市场)
在Claude Code中,先注册市场:
/plugin marketplace add obra/superpowers-marketplace
![![[Pasted image 20260215162344.png]](https://i-blog.csdnimg.cn/direct/3a453b43ba1c4d399a8cfa98957f5115.png)
然后从这个市场安装插件:
/plugin install superpowers@superpowers-marketplace
手动安装的方式。
Step 1:克隆仓库
git clone https://github.com/obra/superpowers.git
Step 2:复制到 skills 目录
Claude Code 的 skills 目录在:
- 全局:~/.claude/skills/
- 项目级:你的项目/.claude/skills/
推荐放到项目级目录,这样不同项目可以用不同版本的 skills。
cp -r superpowers 你的项目/.claude/skills/
Step 3:重启 Claude Code
退出 Claude Code,再重新启动,它就会自动加载 superpowers skills。
验证安装
开始一个新会话,请Claude帮忙做一些能触发技能的事情(比如“帮我规划这个功能”或“让我们调试这个问题”)。Claude code应该会自动调用相关的超能力技能。
第二个平台:Codex
告诉Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
![![[Pasted image 20260215162506.png]]](https://i-blog.csdnimg.cn/direct/3482f2857a4845d9aa3db424b5425215.png)
详细文档:docs/README.codex.md
OpenCode
告诉OpenCode:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
详细文档:docs/README.opencode.md
这几个平台都是原生支持,不需要额外的配置,那么为什么我之前会说支持全平台呢?
首先这类的对于ai编程的插件只要不是涉及环境,涉及服务器,涉及ui。
都可以统一理解为提示词工程。
按照这样的逻辑其实只需要将全部内容获取下来。
你便可以使用。
之前有人参加黑客松有人问过我一个事情,如何在Antigravity中使用?
似乎其中有一个误会点,就是对于claudecode的误会,因为最近正在一款云端claudecode,主要面向的是agent市场,主打深度协作。
大家可以期待一下。
这类的agent如果排除环境判定,权限检查,多用户架构,只要你不研究ai原理,这类无非就是在循环中添加功能,就是看你怎么添加而已。
大道至简。
所以呢,为了让大家能开箱即用,单独开了一个仓库,直接就可以使用。
https://github.com/147qaz258-ead/superpowers-promptified
![![[Pasted image 20260215173206.png]]](https://i-blog.csdnimg.cn/direct/6380d530caa14d6f8a0459cf9db7d351.png)
你可以和你编程助手说
复刻https://github.com/147qaz258-ead/superpowers-promptified到改项目,将其实的配置文件,设置为全局,每一次使用必须遵循。
这样你就会获取和原本插件等同的体验。
方便性可能会小一点,但是差不多。
那么现在就是实战指南。
目前我看下来模型越强,这个插件就越强。
官方说法是"agentic skills framework & software development methodology",说人话就是:它教你如何让 AI 按照固定的 7 个步骤来写代码。
维度
其他框架
Superpowers
核心
给一堆 prompt
给完整的 7 步流程
重点
让 AI “聪明点”
让 AI “守规矩”
输出
看运气
可预期
话虽这么说,但它不是全能。这个我们后面会讲。
二、核心七步法(我实测后的理解)
Superpowers 的核心就是这 7 个步骤,按顺序执行:
- brainstorming(头脑风暴)
↓ - using-git-worktrees(创建独立工作区)
↓ - writing-plans(写实施计划)
↓ - subagent-driven-development(子代理开发)
↓ - test-driven-development(测试驱动开发)
↓ - requesting-code-review(代码审查)
↓ - finishing-a-development-branch(完成分支)
在我体验下来,这 7 个步骤最舒服的地方在于:你不会迷失方向。
在我体验下来,目前的 AI 编程主要分为两个流派,就是说基于目标打造,然后第二个是基于强化打造,基于想法打造,
那么你就需要对每个的功能了如指掌。如果是基于需求打造,那么其需求也是相当于功能。
但是假设你团队中会产品经理这样的角色。
那么使用一些更加自动化的插件可能会更好,但是如果你是基于功能,基于你的想法去打造,那么这个插件可能会更好。
他会形成一种确定性的一些交互性的逻辑。
用 Superpowers 之后,每个阶段都有明确的目标和产出。
三、为什么这套流程有用?
3.1 强制你"慢思考"
这个就很关键。
以前我们用 AI,都是:“帮我写个多用户系统架构”,然后 AI 就开始写。
但 Superpowers 要求你:
- 先 brainstorming,把需求想清楚
- 再 writing-plans,把实施步骤写下来
- 最后才 subagent-driven-development,开始写代码
在我体验下来,这就像爬山前的"规划路线"。你多花 10 分钟规划,后面能少走 1 小时弯路。
3.2 每个 step 都是独立 skill
Superpowers 把每个步骤都做成了独立的 skill:
- superpowers:brainstorming - 需求探索
- superpowers:writing-plans - 计划撰写
- superpowers:subagent-driven-development - 子代理开发
- superpowers:test-driven-development - TDD
- superpowers:requesting-code-review - 代码审查、
3.3 测试和审查是强制的
这个太猛了。
Superpowers 把 TDD 和 code review 直接写进了流程:
- Step 5 必须是 test-driven-development
- Step 6 必须是 requesting-code-review
在我体验下来,这就像给 AI 装了个"质检系统"。你没法跳过测试和审查,代码质量自然上去了。
目前我比较推荐的一套流程就是。
4.1 brainstorming(头脑风暴)
什么时候用:
- 新功能开始前
- 需求不清晰时
- 想探索各种可能性时
我实测后的建议:
哪怕你觉得自己需求很清楚了,也建议跑一遍 brainstorming。
原因?AI 会问一些你没考虑到的问题,帮你补齐思路。
4.2 writing-plans(写计划)
什么时候用:
- brainstorming 完成后
- 需要写实施文档时
在我体验下来,这个 skill 产出的计划质量很高,比我自己写的还全面。
它会包含:
- 功能描述
- 技术方案
- 实施步骤
- 风险评估
4.3 subagent-driven-development(子代理开发)
什么时候用:
- 有实施计划后
- 需要把大任务拆成小任务时
这个就很猛:
它会自动把你的计划拆成多个小任务,然后分配给不同的"子代理"并行处理。
在我体验下来,这就像有个"项目经理"帮你协调多个 AI 同时干活。
4.4 test-driven-development(TDD)
什么时候用:
- 写代码前
- 写代码后
实测发现:
强制 TDD 之后,bug 率确实降了很多。但前提是:你得理解 TDD 的思路(先写测试,再写代码)。
如果你不熟悉 TDD,建议先学一下基础概念,再用这个 skill。
4.5 requesting-code-review(代码审查)
什么时候用:
- 代码写完后
- 提交 PR 前
在我体验下来,AI 审查代码时,经常能发现人类忽略的问题:
- 安全漏洞
- 逻辑错误
- 性能问题
但也有个问题:AI 有时候会"过于严格",对一些小事也提意见。
这个你得自己判断,不必全听。
5、Superpowers 的优势(实测总结)
在我体验下来,Superpowers 有 3 个核心优势:
5.1 流程可预期
每个阶段做什么、产出什么,都很清楚。你不会像无头苍蝇一样乱撞。
5.2 质量有保障
强制 TDD + code review,代码质量自然上去。
5.3 可复用
整个流程可以复用到其他项目。你用一次,就会了。
6、Superpowers 的局限(真实体验)
说实话,Superpowers 不是万能的。
6.1 学习成本不小
你得先理解这 7 个步骤是干嘛的,才能用好。
如果你完全不了解软件开发流程,直接上手,可能会觉得"太麻烦了"。
6.2 对简单任务过重了
如果你只是写个 100 行的脚本,用 Superpowers 就像"杀鸡用牛刀"。
在我体验下来,Superpowers 最适合:
- 新功能开发(1000 行代码以上)(越重整体的确定性越高,我通常都能运行3小时以上)
- 复杂任务(需要多步骤完成)
- 团队协作(需要标准化流程)
最后的话
说实话,我刚接触 Superpowers 时,也觉得"太复杂了"。
但在深度使用了几周后,我发现:
它不是让 AI 替你写代码,而是教你如何更好地和 AI 协作。
这个差别很大。
前者是"被动等待",后者是"主动管理"。
在我体验下来,当你掌握了这套方法,你就不再是"求 AI 帮忙",而是"指挥 AI 干活"。
这个感觉,很爽。
我是老吴,Ai时代的积极行动者,日平均编程时间超过10小时。
欢迎大家和我积极交流
更多推荐


所有评论(0)