装了 superpowers-zh 之后,我决定不再”放任”AI 瞎写了

装了 superpowers-zh 之后,我决定不再”放任”AI 瞎写了

说说最近让我认真对待的一个项目。

起因很简单:用 Claude Code 写了一个导出功能,AI 直接开始写代码,两百行一口气出来。我一看——没有分页,没有异步,大数据量直接 OOM。改了三遍才勉强能用。

问题不在 AI 能力不行,而在于它拿到指令就动手,没有任何”先想清楚”的环节。

superpowers-zh 解决的就是这个问题。它源自一个 250k Stars 的明星项目 obra/superpowers,中文增强版由 jnMetaCode 维护,目前 7358 Stars、710 Forks,MIT 协议开源。

它到底做了什么

简单说:给 AI 编程工具装一套”工作方法论”。

每个 skill 对应一个具体的开发环节——头脑风暴、编写计划、执行计划、TDD 驱动、代码审查、系统化调试、Git 工作流……AI 在合适的时机自动触发对应的 skill,不再拿到需求就开写。

效果对比很直观:

没装之前:
你:给用户模块加个批量导出功能
AI:好的,我来实现...直接开始写代码
    export async function exportUsers() { ... }
你:等等,格式不对,没分页,大数据量会 OOM...

装了之后:
你:给用户模块加个批量导出功能
AI:在开始实现之前,我需要了解几个关键问题:
    1. 导出格式是 CSV 还是 Excel?
    2. 预计数据量多大?需要异步处理吗?
    3. 有权限要求吗?
    → 给出 2-3 个方案,确认后再动手

这套机制来自 14 个翻译 skills,底层是上游 superpowers 验证过的工作流程,每个 skill 都有明确的触发条件和执行规范,不是泛泛的”最佳实践”。

为什么特别值得关注

superpowers-zh 在上游基础上加了中国开发者专属内容,这是它和英文原版的实质差异:

支持工具从 6 款扩展到 20 款。 包括 Claude Code、Copilot CLI、Cursor、Windsurf、Kiro、Gemini CLI、Codex、Aider、Trae、VS Code、DeerFlow、OpenCode、OpenClaw、Qwen Code(通义灵码)、Antigravity、Claw Code、Qoder,以及国产的腾讯 CodeBuddy 和华为云码道 CodeArts。一条命令 npx superpowers-zh 自动识别项目里装了什么工具,把对应的 skills 装到正确位置。

国内 Git 生态全适配。 Gitee、Coding、极狐 GitLab、腾讯云原生构建 CNB 的 CI/CD 示例都有,不像上游只照顾 GitHub。

6 个中国原创 skills。 中文代码审查规范(适配国内团队沟通文化)、中文 Git 工作流、中文技术文档排版规范、中文提交规范(Conventional Commits 中文适配),以及两个自动触发的 MCP 服务器构建和工作流执行器。

v1.7.1(2026 年 7 月 17 日)刚刚对齐上游 v6 重写,双审查者合并为一个 task-reviewer-prompt.md,新增 scripts/review-packagescripts/task-brief,支持中文任务简报抽取。多智能体 eval 跑通了 9 个任务的完整流程。

适合谁,不适合谁

适合:

  • 已经用上 Claude Code/Cursor/Windsurf 等工具,但感觉 AI 经常”瞎写”、返工多的开发者
  • 团队想规范 AI 辅助开发的流程,让 AI 的产出更可控
  • 同时维护多个项目、想一套方法论通吃的主流工具用户
  • 需要中文文档规范和国内 Git 生态适配的国内团队

不适合:

  • 还在犹豫要不要用 AI 编程工具的人(先选好工具再说)
  • 只需要简单 AI 补全、从不跑复杂任务的轻量用户(skill 体系对这类场景属于杀鸡用牛刀)
  • 完全不用上述 20 款工具的少数派(目前不覆盖 Vim/Emacs 插件形态)

使用门槛

技术门槛不高,但有几点要说清楚:

安装本身很简单,npx superpowers-zh 一条命令搞定,不需要懂 npm/node 原理。但如果你用 ~/.home 跑项目级安装,从 v1.2.1 起会主动拒绝,避免污染 home 目录——这个保护机制需要了解,否则会困惑”为什么装不上”。全局安装用 npx superpowers-zh --global,多项目用户建议这个方式。

AI 工具本身需要付费或者有 API Key,这个不用多说。

部分 skill 如 chinese-code-review 是手动调用(需要喊 /chinese-code-review),不是全自动;自动触发的 skill 依赖工具的 plugin 机制,Cursor/Windsurf 这类 IDE 的 skill 加载方式各有不同,官方有详细的安装指南

链接汇总

下一步建议

如果你动心了,可以按这个顺序试:

第一步: 在一个现有项目里跑 npx superpowers-zh,看看它自动识别出了哪些工具、装了哪些 skills,不满意 npx superpowers-zh --uninstall 能干净卸载。

第二步: 读一下 brainstorming skill 的内容(就在安装目录里),理解它的工作流设计,下一次提需求前先让 AI”做头脑风暴”而非直接写代码,感受一下流程差异。

第三步: 如果团队有代码审查流程,试一下 requesting-code-review 和中文版的 /chinese-code-review,看 AI 给出的审查意见是否比直接裸写更严格、更有参考价值。

总结:superpowers-zh 不是又一个 AI 提示词集合,它是给 AI 编程工具装上了结构化的工作框架。 代价是 AI 不会上来就写代码了,每次都要先过一遍思考流程——对于真正想做好产品而不是快速出草稿的团队,这个代价值得。

评论区

0 条评论

登录后可评论。

智源·AI 开源观察 447 阅读