你有没有想过,为什么同样是用AI写代码,有些人写出来的质量很高,有些人写出来的就是一坨?
差别不在AI,在于你怎么”训练”它。
今天介绍一个244K Star的神级项目——Superpowers。它不是一个工具,而是一套给AI注入”工程超能力”的技能框架。
一句话总结:让AI从”会写代码”进化到”会做工程”。
一、AI编码的现状
先说个扎心的事实:大多数人在”用AI写代码”,而不是”让AI做工程”。
用AI写代码:
- 给个需求,AI噼里啪啦写一堆
- 能跑就行,不管质量
- 没有测试,全靠手动验证
- 改一个bug,引入三个新bug
让AI做工程:
- 先设计,再实现
- 测试先行,代码后写
- 系统化调试,不瞎猜
- 代码审查,质量保障
区别在哪?纪律和方法论。
二、Superpowers是什么?
Superpowers是一个开源的代理技能框架和软件开发方法论。
它的核心理念:给AI注入一套”工程技能”,让它像资深工程师一样思考和工作。
包含14个核心技能:
- brainstorming — 需求头脑风暴
- writing-plans — 编写实施计划
- executing-plans — 执行计划
- test-driven-development — 测试驱动开发
- systematic-debugging — 系统化调试
- receiving-code-review — 接受代码审查
- requesting-code-review — 请求代码审查
- verification-before-completion — 完成前验证
- finishing-a-development-branch — 完成开发分支
- using-git-worktrees — 使用Git工作树
- dispatching-parallel-agents — 调度并行代理
- subagent-driven-development — 子代理驱动开发
- using-superpowers — 使用Superpowers本身
- writing-skills — 编写新技能
三、快速开始
3.1 安装
Superpowers的安装方式取决于你用什么AI工具:
Claude Code:
`bash
/plugin install superpowers@claude-plugins-official
`
Cursor:
`bash
/add-plugin superpowers
`
OpenCode:
`bash
# 自动集成到 .opencode/ 目录
`
手动安装:
`bash
git clone https://github.com/obra/superpowers.git ~/superpowers
`
3.2 基本使用
安装后,Superpowers的技能会自动注入到你的AI工具中。
当你和AI对话时,它会自动遵循这些技能定义的流程。
四、核心技能详解
4.1 Brainstorming(头脑风暴)
解决的问题:需求不明确就开写
在写代码之前,先让AI帮你梳理需求:
`
用户:我想做一个任务管理App
AI:[进入brainstorming模式]
- 目标用户是谁?
- 核心功能有哪些?
- 技术栈怎么选?
- MVP范围是什么?
`
关键约束:未经批准,不得实现。
4.2 Writing Plans(编写计划)
解决的问题:没有计划就开干
需求明确后,生成详细的实施计划:
`
AI:[生成计划]
1. 数据库设计(2小时)
2. API接口开发(4小时)
3. 前端页面开发(6小时)
4. 测试和调试(4小时)
5. 部署上线(2小时)
`
4.3 Test-Driven Development(TDD)
解决的问题:先写代码再补测试(永远补不上)
Superpowers强制执行TDD流程:
`
- 先写失败的测试
- 写最少的代码让测试通过
- 重构代码
- 重复
铁律:测试不红,不准写代码。
`
4.4 Systematic Debugging(系统化调试)
解决的问题:遇到bug就瞎猜
系统化调试流程:
`
- 复现问题
- 收集信息(日志、堆栈、状态)
- 形成假设
- 验证假设
- 修复问题
- 验证修复
- 防止回归
`
关键原则:先根因分析,再修复。不瞎猜。
4.5 Code Review(代码审查)
解决的问题:写完就提交,不review
自动进行代码审查:
`
检查清单:
- 代码风格是否一致?
- 是否有安全漏洞?
- 是否有性能问题?
- 测试是否充分?
- 文档是否完整?
不通过不能合并。
`
五、工作流示例
让我们看看Superpowers的完整工作流:
5.1 传统流程(没有Superpowers)
`
用户:帮我写一个登录功能
AI:好的![直接写代码]
用户:等等,密码没加密
AI:哦,改一下
用户:等等,没写测试
AI:好吧,补一下
用户:等等,没考虑并发
AI:……
`
5.2 Superpowers流程
`
用户:帮我写一个登录功能
AI:[brainstorming] 让我们先梳理需求
- 支持哪些登录方式?
- 密码策略是什么?
- 是否需要记住登录状态?
- 是否需要双因素认证?
用户:支持邮箱+密码,密码要加密,记住7天
AI:[writing-plans] 这是我的实施计划…
1. 数据库设计
2. API接口
3. 前端页面
4. 测试
用户:看起来不错,开始吧
AI:[test-driven-development] 先写测试
[executing-plans] 按计划实施
[code-review] 自动审查
[verification] 完成前验证
用户:完美!
`
六、为什么Superpowers有效?
6.1 强制流程
Superpowers不是”建议”,而是”强制”。
就像军队的纪律:
- 不是”建议你站直”,而是”必须站直”
- 不是”建议你写测试”,而是”必须先写测试”
6.2 外部化流程
传统的AI编码是”聊天”,聊完就忘了。
Superpowers把流程落到文件:
- 规范文档:记录需求和设计
- 计划文档:记录实施步骤
- 测试文档:记录测试用例
- 审查记录:记录代码审查结果
6.3 可复用性
一旦定义了技能,所有项目都能用:
- 个人项目:用默认技能
- 团队项目:定制团队技能
- 特定领域:定制领域技能
七、与其他工具对比
| 特性 | Superpowers | OpenSpec | Spec-Kit |
|---|
|——|————-|———-|———-|
| 核心定位 | 执行纪律 | 规范管理 | 流程骨架 |
|---|---|---|---|
| TDD强制 | 是 | 否 | 否 |
| Code Review | 强制 | 可选 | 可选 |
| 上手成本 | 低-中 | 中等 | 中等 |
| 适合场景 | 所有项目 | 已有项目 | 新项目 |
| Token消耗 | 中高 | 低 | 中等 |
7.1 Superpowers vs OpenSpec
- Superpowers:管”怎么做”——流程、纪律、质量
- OpenSpec:管”做什么”——需求、规范、设计
两者组合使用效果最佳。
7.2 Superpowers vs 传统敏捷
Superpowers本质上是把敏捷开发的最佳实践编码成AI可执行的规则:
- TDD → test-driven-development技能
- Code Review → receiving/requesting-code-review技能
- Sprint Planning → writing-plans技能
- Retrospective → verification-before-completion技能
八、实战案例
8.1 案例:个人项目
我用Superpowers开发一个CLI工具:
`
- [brainstorming] 梳理需求,明确MVP范围
- [writing-plans] 生成实施计划,预计3天
- [test-driven-development] 先写测试用例
- [executing-plans] 按计划实施
- [code-review] 自动审查,发现2个安全问题
- [verification] 完成前验证,所有测试通过
- [finishing-branch] 合并到主分支
`
结果:3天完成,代码质量很高,没有线上bug。
8.2 案例:团队协作
团队引入Superpowers后:
- 代码风格统一:技能定义了统一的编码规范
- 测试覆盖率提升:TDD强制执行
- Code Review效率提高:自动审查减少人工审查时间
- 新人上手快:技能就是最佳实践文档
九、Superpowers的哲学
Superpowers背后有一个深刻的哲学:AI的能力上限不在于模型本身,而在于你怎么用它。
就像一个优秀的程序员:
- 不是因为他打字快
- 而是因为他知道该怎么设计、该怎么做工程
Superpowers就是把”怎么做工程”的知识编码成AI可执行的规则。
十、不足与展望
当前不足
- 流程较重,小项目可能觉得繁琐
- Token消耗较高(每次注入完整技能库)
- 依赖AI工具的执行能力
未来展望
- 更多技能包(安全、性能、部署等)
- 与CI/CD深度集成
- 团队协作功能增强
- 更智能的技能推荐
十一、我的使用建议
- 先试默认技能:别急着定制,先用默认流程感受一下
- 小项目练手:用小项目熟悉流程,再用到大项目
- 配合OpenSpec使用:Superpowers管执行,OpenSpec管规范
- 定期更新:Superpowers更新频繁,记得pull最新版本
- 团队统一:如果团队使用,先统一技能配置
总结
Superpowers解决了一个核心问题:如何让AI从”会写代码”进化到”会做工程”。
它不是要限制AI的能力,而是给AI一套”工程方法论”,让它像资深工程师一样思考和工作。
如果你:
- 受够了AI乱写代码
- 想要工程级的代码质量
- 需要可重复的开发流程
那Superpowers值得一试。
项目地址:https://github.com/obra/superpowers
你用过Superpowers吗?或者你有什么让AI”工程化”的技巧?欢迎评论区分享!
发表回复