superpowers-zh（AI 编程超能力 · 中文增强版）

🌐 简体中文 | 繁體中文 | English (upstream)

🦸 superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 23 款 AI 编程工具真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。

Chinese community edition of superpowers — 20 skills across 23 AI coding tools, including full translations and China-specific development skills.

📖 免费配套学习 → 从零学会 AI 编程（180 节）＋ 从零构建 AI 智能体（40 节）：两门免费实操课 + 实战社区，superpowers 装好后配上方法论效率翻倍

🌍 Also available in English · 日本語 · Español · 한국어 · 繁體中文

🆕 v1.7.8 更新亮点（完整 Release Notes →）

• 🔍 定位核查 —— 逐层比对上游，修掉 5 处「不是增量」的偏离；新增 audit 检查强制 fork 增量必须显式声明
• 🆕 新增 Crush（工具数 22 → 23）—— 若你已为 CC / Cursor / Codex 装过，Crush 其实已经能读到，别重复装
• 🎯 上游 v6.2.0 对齐完成 —— audit 的结构漂移告警清零；C 块盘点时发现其中 3 项不是风格改动而是实质新规则
• 🐛 两个 worktree / Gemini 的真问题 —— 修掉 worktree 清理静默空转；更正「Gemini 不支持子智能体」的错误说法（原说法会让 3 个 skill 在 Gemini CLI 上瘸腿）
• 🔄 测试参考重构 —— testing-anti-patterns → writing-good-tests：从 5 个反模式清单改为两条原则 + 变异检查
• 🔄 SDD 同步上游 v6.2.0 —— plan 作用域工作区（一份过期账本再也不会让控制者跳过整段任务）+ 五轮上限的唤回式修复循环与熔断裁定
• 🪟 Windows bootstrap 修复 —— SessionStart hook 改经 Git Bash 分发（同步上游），hook 不加载 skill 就是死重
• 🧩 新增 Cline 与 Kilo Code 两款 VS Code 扩展（工具数 20 → 22）—— 按 rules 常驻开销做了专门设计，索引仅 4.5 KB
• 🔧 检测落空时会扫 PATH 给出可直接复制的 --tool 命令，不再只报「未检测到」
• 📦 README 补上 Plugin Marketplace 安装方式（claude plugin marketplace add，升级只需一条命令）

📊 项目规模

| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 | |:---:|:---:|:---:| | 14 | 6 | Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）/ Cline / Kilo Code / Crush |

---

❤️ 赞助商  _{🙏 想出现在这里？联系 jnMetaCode@qq.com 赞助}

<table> <tr> <td width="25%"> <a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh"> <img src="assets/sponsors/compshare.jpg" alt="优云智算 by UCloud — 热门国产模型按次调用套餐包，低至 49 元/月起" width="100%"> </a> </td> <td width="75%" valign="middle">

感谢 优云智算 赞助本项目！优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，支持 GLM-5.2，低至 49 元/月起。同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7×24 技术支持、自助开票。🎁 通过此链接注册的用户，可得免费 5 元平台体验金！

</td> </tr> </table> <table> <tr> <td width="25%"> <a href="https://cubence.com/signup?code=SCW29JP9"> <img src="assets/sponsors/cubence.jpg" alt="Cubence — 专业 AI API 网关，稳定高效的 API 中转服务，支持 Claude Code、Codex、Gemini 等多种模型" width="100%"> </a> </td> <td width="75%" valign="middle">

感谢 Cubence 对本项目的支持。Cubence 是一家致力为客户提供稳定、高效的 API 中转服务商。从 25 年 9 月运营至今，提供了 Claude Code、Codex、Gemini 等多种模型支持。🎁 Cubence 为本开源项目的用户提供了特别的专属优惠码 AGENCY，通过此链接注册的用户，首次购买即可享受 9 折优惠！

</td> </tr> </table>

---

这是什么？

superpowers 是目前最火的 AI 编程 skills 框架（250k+ stars），为 AI 编程工具提供系统化的工作方法论。

superpowers-zh 在完整翻译的基础上，新增了面向中国开发者的特色 skills。

<!-- 效果对比 --> <table> <tr><td>

没装 superpowers-zh：

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

</td><td>

装了 superpowers-zh：

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

</td></tr> </table>

🆚 与英文上游的区别（老被问，一次说清）

| 维度 | superpowers（英文上游） | superpowers-zh（中文增强版） | |------|----------------------|---------------------------| | ⭐ Star 数 | 250k+ | — | | 📦 Skills 总数 | 14 | 20（14 翻译 + 4 国产原创 + 2 上游历史保留） | | 🌐 语言 | 英文 | 中文（技术术语保留英文） | | 🤖 支持工具 | 6 款：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | 23 款：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） / Cline / Kilo Code / Crush | | ⚡ 安装方式 | 按工具分别装（每款一条不同的 plugin marketplace 命令） | npx superpowers-zh 一条命令自动识别项目里的工具并安装；识别不出可 --tool <name> 显式指定 | | 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + CNB（腾讯云原生构建） | | 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + .cnb.yml | | 🇨🇳 代码审查风格 | 西方直接风格 | 适配国内团队沟通文化 | | 🇨🇳 Git 提交规范 | 无 | Conventional Commits 中文适配 | | 🇨🇳 中文文档规范 | 无 | 中文排版 + 中英混排规则 + 告别机翻味 | | ➕ MCP 服务器构建 | 无 | 独立 mcp-builder skill | | ➕ 工作流执行器 | 无 | 独立 workflow-runner skill（多角色 YAML 编排） | | ➕ 翻译 skill 内的增量 | — | 仅 2 处，均在正文显式标注「本节是 superpowers-zh 的增量内容」：executing-plans 的「常见异常处理」、using-superpowers 的「中国特色技能路由」。上游各节均为逐节翻译，不被改动；audit 会强制未标注的增量报错 | | 🔄 版本跟进 | 独立迭代 | 同步上游 + 国产增量叠加 | | 🤝 接受新 skill PR | 一般不接受（原文："we don't generally accept contributions of new skills"） | 欢迎 PR（中国开发者痛点优先） | | 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 | | 📜 License | MIT | MIT |

一句话总结： 英文上游 = 方法论内核；中文增强版 = 方法论内核 + 23 款工具一键适配 + 国内 Git/CI 生态 + 中文化表达习惯。

🤖 支持 23 款主流 AI 编程工具

| 工具 | 类型 | 一键安装 | 手动安装 | |------|------|:---:|:---:| | Claude Code | CLI | npx superpowers-zh | .claude/skills/ | | Copilot CLI | CLI | npx superpowers-zh --tool copilot | .claude/skills/ | | Hermes Agent | CLI | npx superpowers-zh --global --tool hermes | ~/.hermes/skills/ | | Cursor | IDE | npx superpowers-zh | .cursor/skills/ | | Windsurf | IDE | npx superpowers-zh | .windsurf/skills/ | | Kiro | IDE | npx superpowers-zh | .kiro/steering/ | | Gemini CLI | CLI | npx superpowers-zh | .gemini/skills/ | | Codex CLI | CLI | npx superpowers-zh | .codex/skills/ | | Aider | CLI | npx superpowers-zh | .aider/skills/ | | Trae | IDE | npx superpowers-zh | .trae/skills/ + .trae/rules/ | | VS Code (Copilot) | IDE 插件 | npx superpowers-zh | .github/superpowers/ | | DeerFlow 2.0 | Agent 框架 | npx superpowers-zh | skills/custom/ | | OpenCode | CLI | npx superpowers-zh | .opencode/skills/ | | OpenClaw | CLI | npx superpowers-zh | skills/ | | Qwen Code (通义灵码) | IDE 插件 | npx superpowers-zh | .qwen/skills/ | | Antigravity | CLI | npx superpowers-zh | .agents/skills/ | | Claw Code | CLI (Rust) | npx superpowers-zh | .claw/skills/ | | Qoder (阿里 AI IDE) | IDE | npx superpowers-zh | .qoder/skills/ + .qoder/rules/ | | CodeBuddy (腾讯 AI IDE) | IDE | npx superpowers-zh | .codebuddy/skills/ + CODEBUDDY.md | | 华为云码道 CodeArts | IDE | npx superpowers-zh | .codeartsdoer/skills/ | | Cline | IDE 插件 | npx superpowers-zh --tool cline | .cline/skills/ + .clinerules/ | | Kilo Code | IDE 插件 | npx superpowers-zh --tool kilocode | .kilocode/skills/ + .kilocode/rules/ | | Crush | CLI | npx superpowers-zh | .crush/skills/ |

运行 npx superpowers-zh 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。

翻译的 Skills（14 个）

| Skill | 用途 | |-------|------| | 头脑风暴 (brainstorming) | 需求分析 → 设计规格，不写代码先想清楚 | | 编写计划 (writing-plans) | 把规格拆成可执行的实施步骤 | | 执行计划 (executing-plans) | 按计划逐步实施，每步验证 | | 测试驱动开发 (test-driven-development) | 严格 TDD：先写测试，再写代码 | | 系统化调试 (systematic-debugging) | 四阶段调试法：定位→分析→假设→修复 | | 请求代码审查 (requesting-code-review) | 派遣审查 agent 检查代码质量 | | 接收代码审查 (receiving-code-review) | 技术严谨地处理审查反馈，拒绝敷衍 | | 完成前验证 (verification-before-completion) | 证据先行——声称完成前必须跑验证 | | 派遣并行 Agent (dispatching-parallel-agents) | 多任务并发执行 | | 子 Agent 驱动开发 (subagent-driven-development) | 每个任务一个 agent，两轮审查 | | Git Worktree 使用 (using-git-worktrees) | 隔离式特性开发 | | 完成开发分支 (finishing-a-development-branch) | 合并/PR/保留/丢弃四选一 | | 编写 Skills (writing-skills) | 创建新 skill 的方法论 | | 使用 Superpowers (using-superpowers) | 元技能：如何调用和优先使用 skills |

🇨🇳 中国特色 Skills（6 个）

⚠️ 下表前 4 个 chinese-* 为「手动调用」skill——不会自动触发，需在对话中显式输入 /chinese-xxx 才会加载。 设计为参考资料而非工作流，避免污染上游 skill 的自动调度（如 requesting-code-review、brainstorming 等）。

| Skill | 用途 | 调用方式 | 上游有吗？ | |-------|------|---------|:---:| | 中文代码审查 (chinese-code-review) | 符合国内团队文化的代码审查规范 | /chinese-code-review（手动） | 无 | | 中文 Git 工作流 (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab/CNB | /chinese-git-workflow（手动） | 无 | | 中文技术文档 (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | /chinese-documentation（手动） | 无 | | 中文提交规范 (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | /chinese-commit-conventions（手动） | 无 | | MCP 服务器构建 (mcp-builder) | 构建生产级 MCP 工具，扩展 AI 能力边界 | 自动 | 无 | | 工作流执行器 (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 自动 | 无 |

---

快速开始

方式一：npm 安装（推荐）

项目级（默认，装到当前项目）：

cd /your/project
npx superpowers-zh

⚠️ 项目级安装不要在主目录（~）下跑。v1.2.1 起会拒绝并提示，老版本会把 skills 和 CLAUDE.md 等 bootstrap 文件写到你的 home 目录，污染所有项目。如已误装见下文「卸载 / 误装清理」。想让 skills 对所有项目生效，请用下面的全局安装，而不是在 ~ 下跑项目级。

全局安装（v1.7.0+，装到用户目录，所有项目共享，适合同时维护多个项目）：

npx superpowers-zh --global                 # 自动检测已装工具
npx superpowers-zh --global --tool claude   # 或指定工具

全局安装把 skills 装到工具的用户级目录（如 ~/.claude/skills），一次安装所有项目自动可用，更新时也只需重装一次。项目级优先、全局兜底，二者可共存。

支持通用全局安装的工具（均为 docs 已证实的用户级加载路径）：Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent。其中 Codex CLI 全局装到 ~/.agents/skills（Codex 启动扫描目录）。其余工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Claw / Cline / Kilo Code）规则是项目级或存于应用内设置，--global 会提示改用项目级；Gemini CLI / Antigravity 有各自专属的全局方式（Gemini 走扩展目录），见对应 docs/README.*.md。

| | 项目级（默认） | 全局（--global） | |---|---|---| | 安装位置 | <项目>/.claude/skills 等 | ~/.claude/skills 等用户级目录 | | 生效范围 | 仅当前项目 | 所有项目 | | 适合 | 单项目、需项目内版本固定 | 多项目、想一次装好到处可用 | | 卸载 | npx superpowers-zh --uninstall | npx superpowers-zh --global --uninstall |

方式二：Claude Code Pl