一个让我崩溃的下午

上周我让 Claude Code 帮我给一个内部系统加批量导出功能。它二话不说，30 秒写完一个 exportUsers() 接口就告诉我"搞定了"。

我去看代码：没分页、没异步、10 万条数据直接全加载到内存。上线必 OOM。

改了一轮，它又"搞定了"。这次分页逻辑写反了，第一页和第二页数据重复。

又改了一轮……

这不是个例。用 AI 编程工具越久，越觉得它们有个共同的毛病：能力很强，但做事没章法。你说什么它就写什么，写之前不问、写完不验。

后来我在 GitHub trending 上看到一个叫 superpowers 的项目（中文版：superpowers-zh），一周涨了好几万 star（现在 116k 了）。看完 README 和 skills 源码，我理解它为什么火了。

superpowers 到底是什么

不是插件，不是 Agent 框架，是一组 skill 文件——本质上是一套结构化的提示词，告诉 AI 助手在不同阶段该怎么工作。

比如 brainstorming 这个 skill，加载后 AI 在接到任何需求时，必须先走这个流程：

1. 探索项目上下文（读文件、看最近 commit）
2. 提出澄清问题（每次一个，不批量甩）
3. 给出 2-3 种方案 + 权衡分析
4. 展示设计，获得你的确认
5. 确认后才开始写代码

还有 systematic-debugging，遇到 bug 时强制走四个阶段：

第一阶段：根因调查（收集证据，不许猜）
第二阶段：形成假设
第三阶段：验证假设
第四阶段：确认根因后才提修复方案

铁律：不做根因调查，不许提修复方案。

还有 verification-before-completion，AI 在说"完成了"之前，必须先跑验证命令，拿到实际输出作为证据。没有证据不许宣称完成。

说白了就是给 AI 定了规矩：先想清楚再动手，干完了要验证。

这些其实就是资深工程师做事的方式，只是以前 AI 工具没人教它这些。

中文用户可以试试 superpowers-zh

superpowers 本身是全英文的，加载后 AI 的设计方案、审查意见、确认对话也全是英文。自己用没问题，团队协作就有点别扭。

GitHub 上有人做了个中文版 superpowers-zh，14 个 skill 全部翻译了，术语保留英文（commit 不会翻译成"提交物"）。

比较有意思的是它额外加了几个国内场景的 skill。比如中文代码审查，改变了审查的表达方式：

# 英文版审查风格
This is wrong. You should use X instead.

# 中文版审查风格
[建议修改] 这里用 sync 方式读文件是出于什么考虑？
如果并发量上来，可能会阻塞事件循环。建议考虑 async 方案。

用"提问"代替"否定"。发到 PR comment 里同事能接受，但安全漏洞这些标 [必须修复]，不会因为客气而放过。

还有中文 Git 工作流适配 Gitee/极狐 GitLab，中文提交规范让 git log 不再中英混搭。

实际使用感受

用了一周，说几个实际的变化。

最明显的：AI 开始问问题了。 以前说"加个功能"，它直接写。现在它会先问：导出格式、数据量级、异步需求、权限要求。有时候问的问题会提醒我一些没想到的边界情况。

调试变快了。 以前测试挂了，AI 的套路是猜一个改一个，改了不行再猜。现在它会先看日志、看最近改动、看堆栈，形成假设再去验证。不能说每次都一次命中，但至少不会在一个错误方向上循环 5 次。

"完成了"变可信了。 以前 AI 说完成了我还得自己去跑一遍测试确认。现在 verification-before-completion skill 强制它在宣称完成前必须跑验证，把测试输出贴出来。如果有 failed test，它不会说"搞定了"。

也有不足： 有些简单改动（比如改个文案、调个样式），它也会走完整的头脑风暴流程，问一堆澄清问题。有点过度了。这时候直接告诉它"跳过设计直接改"就行。

安装

英文版：

npx superpowers

中文版，支持 Claude Code、Cursor、Windsurf、Kiro、Gemini CLI、通义灵码等 14 款工具：

cd /your/project
npx superpowers-zh

会自动检测你项目里用的是什么工具，把 skill 文件复制到对应位置。装完之后正常使用就行，AI 会自动加载 skill。

最后

AI 编程工具的模型能力已经很强了，但"能力"和"方法论"是两回事。一个没有方法论的高手也会犯低级错误——不验证就说搞定了、不分析就猜测式修 bug、不问需求就直接写代码。

superpowers 做的事情就是给 AI 注入方法论。中文用户可以试试 superpowers-zh，用着更顺手一些。

• 英文版：/obra/superpowers
• 中文版：/jnMetaCode/superpowers-zh