先看一个扎心的对比
同样是给AI下一条指令，你的AI和装了它的AI，反应完全不一样：
没装：
你：给用户模块加个批量导出功能
AI：好的，我来实现...（直接开始写代码）
export async function exportUsers() { ... }
你：等等，格式不对，没分页，大数据量会 OOM...
装了：
你：给用户模块加个批量导出功能
AI：在开始实现之前，我需要了解几个关键问题：
1. 导出格式是 CSV 还是 Excel？
2. 预计数据量多大？需要异步处理吗？
3. 有权限要求吗？
→ 给出 2-3 个方案，确认后再动手
看出区别了吗？
一个AI是"打字员"，一个是"工程师"。
这就是 Superpowers 干的事：它不是一个AI模型，不是一个编程工具，而是一套装进AI脑子里的工作方法论——让AI在写代码之前，先想清楚。
什么来头？说出来吓你一跳
- 作者：Jesse Vincent，GitHub 联合创始人（没错，就是全世界最大的代码托管平台那个GitHub）
- Star：250k+，GitHub 上最火的 AI 编程框架之一
- 认证：Claude 官方认证插件，上架 Anthropic 官方插件市场，安装量 23 万+，排名第二
一句话：AI编程圈的"教科书级"项目。
它的思路其实很朴素——AI 之所以老返工，不是因为它笨，是因为它太"急"。你说个需求，它马上动手，做出来才发现你根本不是那个意思。
Superpowers 把"先想清楚再动手"这条铁律，强制写进了 AI 的底层逻辑：需求分析、方案设计、计划拆解、逐步验证、代码审查——每一步都有专门的"技能"（Skill）管着。
中文版：为什么值得单独说？
原版很好，但对国内开发者有三个门槛：全英文、只适配6款工具、没有中国开发习惯。
superpowers-zh 就是来拆这三堵墙的。它把原版 15 个技能全部汉化，再加了 4 个中国原创技能 + 2 个上游保留技能，共 21 个技能：
| | |
|---|
| 头脑风暴 / 执行计划 / 系统化调试 / 代码审查 / 子Agent驱动开发 / 并行Agent / Git Worktree... | |
| 中文代码审查 / 中文Git工作流 / 中文技术文档 / 中文提交规范 | |
| | |
最实在的差异化：
- 支持 26 款 AI 编程工具——Claude Code、Cursor、Copilot CLI、Codex、Gemini CLI、Aider、Trae、Qwen Code、Cline、腾讯CodeBuddy、华为云码道、智谱ZCode…… 原版只适配6款，中文版把国内主流工具全包了
- 国内Git平台适配——GitHub + Gitee + Coding + 极狐GitLab + 腾讯云CNB，CI/CD 示例也换成国内的
-
中文文档规范——中文排版、中英混排规则，告别机翻味
- 免费配套课程——从零学会AI编程（182节）+ 从零构建AI智能体（40节），站上共13门课648节，全部免费
三个真亮点
亮点 1：不是翻译，是"翻译 + 增量"的工程化方案。 汉化项目常见的翻车姿势：纯机翻没人用，或改得面目全非没法跟上游。superpowers-zh 的做法是 15 个上游 skills 逐节翻译、正文不动，增量只在两处且显式标注"本节是 superpowers-zh 的增量内容"，audit 机制强制检查——未标注的增量直接报错。上游更新就同步叠加，版本跟进是制度化的。
亮点 2：26 款工具一条命令。 上游只支持 6 款工具，每款还要跑不同的安装命令。中文版扩到 26 款：Claude Code、Cursor、Codex、Trae、Qwen Code、腾讯 CodeBuddy、华为云码道 CodeArts、智谱 ZCode、阿里 Qoder、Gemini CLI、Aider、DeepSeek Harness 等。npx superpowers-zh 自动检测项目里装了哪些工具、把 21 个 skills 放进每款的正确路径，识别不出可
--tool 显式指定。
亮点 3：卸载比安装还讲究。 v1.2.1 起所有写进 CLAUDE.md/GEMINI.md 的内容都包在 ~ 下执行，连"管理员 PowerShell 里跑会把 skills 装进 C:\Windows\System32"这种坑都补了护栏，且不给 --force 绕过。这种工程洁癖在个人项目里不多见。
21 个 skills 的三层结构
1、15 个翻译 skills，覆盖完整工作流链路——头脑风暴（不写代码先想清楚）→ 编写/执行计划 → TDD（先写测试再写代码）→ 系统化调试（定位→分析→假设→修复）→ 请求/接收代码审查 → 完成前验证（声称完成前必须跑验证）→ Git Worktree 隔离开发 → 完成开发分支，外加派遣并行 Agent、子 Agent 驱动开发等 多智能体玩法。
2、4 个中国原创 skills，全部手动调用（需显式输入 /chinese-xxx，避免污染上游自动调度）：中文代码审查（适配国内沟通文化，不像西式审查那样直给）、中文 Git 工作流（Gitee / Coding / 极狐 GitLab / CNB）、中文技术文档（中文排版 + 中英混排，专治机翻味）、中文提交规范（Conventional Commits 中文适配）。
3、2 个上游历史保留——mcp-builder（构建 MCP 服务器）和 workflow-runner（多角色 YAML 编排），上游删了，这个 fork 继续维护。15 + 4 + 2 = 21。
安装产物也不只是裸拷文件夹：完整 plugin 含 skills/ + hooks/（SessionStart 钩子自动触发）+ CLAUDE.md/GEMINI.md 等 bootstrap 引导 + 4 套 plugin manifest。官方强调手动 cp -r 是低保真安装——skills 物理存在但 AI 不会自动调用，始终推荐走 npx。
安装与配置
# 方式一（推荐）：npm 一条命令
cd /your/project
npx superpowers-zh # 自动检测项目里的工具
npx superpowers-zh --global # 全局安装（v1.7.0+），所有项目共享
# 方式二：Claude Code 插件市场（仅 Claude Code，升级只需 plugin update）
claude plugin marketplace add jnMetaCode/superpowers-zh
claude plugin install superpowers-zh@superpowers-zh
注意：项目级安装别在主目录 ~ 下跑，v1.2.1 起会直接拒绝；想全局生效用 --global。手动 cp -r 仅极端无网环境的备选。卸载：npx superpowers-zh@latest --uninstall，哨兵注释保证只删自己的内容。
团队落地
统一认知：团队里 AI 工具五花八门（Claude Code、Trae、CodeBuddy、Cursor 都有）没关系，26 款全覆盖、skills 内容一致——大家拿到的是同一套工作流，而不是各自凭手感调教 AI。
沉淀规范：4 个中文 skills 正对团队协作三个高频摩擦点——代码审查语气（国内团队吃"先肯定再建议"，西式直给容易吵起来）、提交信息格式（Conventional Commits 中文适配）、文档排版（中英混排统一，告别机翻味）。都是 markdown，团队可 fork 后按自己规范再改。
门禁：仓库预置了 Gitee Go / Coding CI / 极狐 CI / .cnb.yml 示例配置，把"完成前验证"“接收代码审查"的检查项固化进流水线，AI 自查 + CI 兜底双保险。
扩展：上游明说"we don't generally accept contributions of new skills"（一般不收新 skill），这个 fork 反过来欢迎 PR、中国开发者痛点优先——团队自研方法论可以反哺主线，不用自己养 fork。
适用场景
该用：用任意 AI 编程工具、想让 AI"按工程方法干活"而不是"拿到需求就乱写"的开发者；饱受审查风格冲突、提交信息混乱、文档机翻味困扰的国内团队；刚上手 AI 编程的新手。
别急着用：只用一款且上游原生支持的工具（如纯 Claude Code 用户），上游原版够用，中文版价值主要在多工具 + 国内生态；期望"装完自动变强"的，4 个中文 skills 是手动调用型，得主动
/chinese-xxx。
优缺点与避坑
优点：方法论内核经 250k+ Star 验证；中文增强是真增量不是贴皮；26 款工具覆盖面目前没有对手；安装/卸载安全设计扎实；open_issues 仅 13维护勤快。
局限与避坑：
- 赞助商广告密度高。README 里 APINEBULA、88API、Cubence、APIMart、火山引擎、Fluxion AI、优云智算、Infistar.cc 共 8 家，几乎全是 API 聚合/中转平台，带优惠码和返佣链接。这是作者的自由，但读者要清楚：这些是广告不是项目背书，用不用请自行甄别。
- 个人项目，无大厂背书。长期维护看作者节奏；8.3k Star 相对上游 250k 是派生体量，上游大改时同步压力不小。
- 手动调用门槛。4 个中文 skills 不会自动触发，团队推广得先教会成员"什么时候敲 /chinese-xxx"。
-
v1.7.12 刚修过插件模式跨技能调用 bug（#124：正文照抄上游
superpowers: 前缀导致 Skill() 全部失败），走 Claude Code 插件市场装的务必更新。
个人观点
客观说，这是一个定位聪明的派生项目：它没试图超越上游，而是把上游最薄弱的三块——中文表达、国内工具生态、中国团队协作文化——补成了自己的护城河。21 个 skills 里真正原创的只有 4 个，但恰恰这 4 个击中的痛点（机翻味文档、西式审查风格、Gitee/CNB 生态）是上游永远不会做的。安装器对 Windows 路径、管理员权限、卸载哨兵注释这些边角的打磨，看得出作者是真在自己日常用它。
但有两件事需要冷静看：首先，skill 方法论的本质是 prompt 工程，上限取决于背后模型的执行力——同一个 skill，模型弱时照样把计划执行歪，这是整个赛道的共同边界；然后，README 的商业化程度（8 家赞助商广告 + 课程导流 + 九个兄弟项目交叉推荐）在开源项目里算重的，项目本身 MIT 免费没问题，但读它的 README 需要自带过滤器。如果你是国内多工具用户或团队负责人，值得装上试试——反正卸载也很体面；如果是单一工具重度用户，先看看上游原版是否够用，再决定要不要这层中文增强。
GitHub仓库： https://opengraph.githubassets.com/1/jnMetaCode/superpowers-zh
