给 AI 编程 Agent 套个"紧箍咒":Superpowers 完整指南

4 阅读4分钟

"AI 写代码挺快,但总差点意思。" "让它干大活,心里没底。" "有没有办法让 AI 按工程规范来?"

这些问题,本质上是同一个问题:如何让 AI 遵守工程纪律?

Superpowers 给出的答案是:不给它选择权。

Superpowers 是什么?

image.png

说人话:就是一套给 AI 编程 Agent 用的"技能包" + "强制流程"。

不是让 AI 想干嘛就干嘛,而是强制它按这套来:

  1. 动手前先想清楚(brainstorming)
  2. 想清楚了写计划(writing-plans)
  3. 按计划写代码,先写测试(TDD)
  4. 写完了自己审一遍(code-review)
  5. 搞定了问你合不合并(finishing)

听着眼熟?这不就是咱们人类老程序员的干活方式吗。

区别在于:人类可能偷懒、可能跳步骤,AI 被强制执行,没得选。

核心技能有哪些?

开发流程类

技能干什么什么时候触发
brainstorming通过提问理清需求,保存设计文档写代码前
writing-plans把大任务拆成 2-5 分钟的小任务设计确认后
test-driven-development先写测试再写代码,红-绿-重构循环编码期间
subagent-driven-development分发任务给子 Agent,两阶段审查执行阶段
executing-plans按计划批量执行,关键节点检查备选执行方式

工程管理类

技能干什么什么时候触发
using-git-worktrees创建隔离分支和工作区开始新功能前
requesting-code-review对照计划自查,问题阻断进度任务间隙
receiving-code-review处理审查反馈收到反馈时
finishing-a-development-branch验证测试,提供合并/清理选项任务完成后

调试验证类

技能干什么什么时候触发
systematic-debugging四步根因分析,不靠猜出 bug 时
verification-before-completion验证问题真的解决了说完成前

元技能

技能干什么
using-superpowers系统入门指南
writing-skills创建和测试新技能

安装方法

Claude Code 用户(推荐)

两行命令搞定:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Codex 用户

直接在对话里粘贴这行:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

OpenCode 用户

同样,对话里粘贴:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

基本用法

装完之后,你不用做任何特殊操作

Superpowers 会自动检测你的指令,在合适的时机触发对应的技能。

典型工作流长这样

第一步:你提需求

帮我给这个项目加个用户登录功能

第二步:AI 进入 brainstorming 模式

它会问你一堆问题:

  • 手机号登录还是邮箱登录?
  • 要不要第三方登录?
  • 忘记密码怎么处理?
  • Session 还是 JWT?

你回答完了,它生成设计文档,等你确认。

第三步:AI 进入 writing-plans 模式

它会把任务拆成:

  • 创建 models/user.go,定义 User 结构体
  • auth/login.go 添加 Login() 函数
  • 写测试验证用户名密码错误的情况
  • 写测试验证 token 生成逻辑
  • 实现 JWT 中间件
  • ...

每个任务 2-5 分钟能搞定,具体到文件和函数名。

第四步:AI 开始干活

这个时候 TDD 就来了:

  1. 先写测试(测试会失败)
  2. 写最少代码让测试通过
  3. 重构优化

没测试的代码?直接删掉。

第五步:代码审查

写完了 AI 会自己审一遍,对照计划看有没有遗漏。

第六步:收尾

所有任务搞定了,它会问你:

  • 所有测试通过了吗?
  • 要合并分支还是保留?
  • 要不要清理工作区?

你选,它执行。

核心理念

Superpowers 背后的逻辑就四条:

image.png

测试驱动

不是"建议写测试",是"没测试代码活不下去"。

系统化优于随机性

流程比灵感靠谱。调试不是"我觉得可能是...",是一步步排查。

降低复杂度

简单是目标,不是副产品。代码越简单,bug 越少。

证据优于声明

别说"我搞定了",跑给我看。

适合谁用?

适合

  • 让 AI 干大活(重构、新功能、大项目)
  • 团队协作,需要统一代码规范
  • 对代码质量有要求的项目

不太适合

  • 写个小脚本
  • 修个简单的 bug
  • 快速验证想法

我怎么看?

这个方向对了。

AI 时代,最难的不是"让 AI 写代码",而是"让 AI 按你的标准写代码"。

Superpowers 做的事,就是把人类的工程规范"翻译"成 AI 能听懂的强制指令。

缺点也有:流程重了点,小项目觉得杀鸡用牛刀。

但如果你让 AI 干大活,这套流程能救命。

最后说句

工具是拿来用的,不是拿来追的。

你觉得 AI 写代码已经挺靠谱,那挺好。

你总被 AI 产的代码坑,不妨试试这套"紧箍咒"。

毕竟再强的猴王,戴上紧箍咒才能取经。