jnMetaCode/superpowers-zh

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，升级只需一条命令）

📊 项目规模

❤️ 赞助商  _{🙏 想出现在这里？联系 [email protected] 赞助}

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

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

这是什么？

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

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

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

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

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

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

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

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

翻译的 Skills（14 个）

🇨🇳 中国特色 Skills（6 个）

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

快速开始

方式一：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。

方式二：Claude Code Plugin Marketplace

仅限 Claude Code。 走官方 plugin 机制装，好处是升级只要一条 claude plugin update，不用重跑 npx：

claude plugin marketplace add jnMetaCode/superpowers-zh
claude plugin install superpowers-zh@superpowers-zh

装完 claude plugin list 应该看到：

  ❯ superpowers-zh@superpowers-zh
    Version: <当前版本>
    Scope: user
    Status: ✔ enabled

升级与卸载：

claude plugin marketplace update superpowers-zh          # 先刷新 marketplace 缓存
claude plugin update superpowers-zh@superpowers-zh       # 再升级 plugin（需重启生效）
claude plugin uninstall superpowers-zh@superpowers-zh    # 卸载

和方式一怎么选？ marketplace 装的是完整 plugin（skills + hooks + bootstrap 由 Claude Code 统一托管、随版本更新），但只服务 Claude Code 一款工具。要装给其余 19 款工具，仍然用方式一的 npx superpowers-zh。两者可以共存，但同一个项目里别重复装 Claude Code，否则 skills 会出现两份。

方式三：手动安装（low-fidelity，仅作备选）

⚠️ 手动 cp -r skills 是低保版安装，不等同于完整 plugin。

superpowers-zh 是一个完整 plugin，包含：skills/（20 个能力）+ hooks/（SessionStart 钩子，让 skill 在合适时机自动触发）+ CLAUDE.md / GEMINI.md 等 bootstrap 引导文件 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。

下面的 cp -r skills 命令只复制 skills 目录，不会自动配置 hooks、不会生成 bootstrap 引导。结果：skills 物理上存在，但 AI 不会在合适时机自动调用，需要你每次手动喊 "use brainstorming skill" 之类。

强烈推荐用方式一 npx superpowers-zh —— 它会一键处理 skills 复制 + bootstrap 生成 + hooks 配置 + 工具特定适配。仅在 npx 不可用（极端无网络环境）时才退到手动。

# 克隆仓库
git clone https://github.com/jnMetaCode/superpowers-zh.git

# 复制 skills 到你的项目（选择你使用的工具）
cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code / Copilot CLI
cp -r superpowers-zh/skills /your/project/.hermes/skills      # Hermes Agent
cp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor
cp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLI
cp -r superpowers-zh/skills /your/project/.kiro/steering      # Kiro
cp -r superpowers-zh/skills /your/project/skills/custom       # DeerFlow 2.0
cp -r superpowers-zh/skills /your/project/.trae/rules         # Trae
cp -r superpowers-zh/skills /your/project/.agents        # Antigravity
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r superpowers-zh/skills /your/project/skills              # OpenClaw
cp -r superpowers-zh/skills /your/project/.windsurf/skills   # Windsurf
cp -r superpowers-zh/skills /your/project/.gemini/skills     # Gemini CLI
cp -r superpowers-zh/skills /your/project/.aider/skills      # Aider
cp -r superpowers-zh/skills /your/project/.opencode/skills   # OpenCode
cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
cp -r superpowers-zh/skills /your/project/.claw/skills       # Claw Code（Rust 版）
cp -r superpowers-zh/skills /your/project/.qoder/skills      # Qoder（阿里 AI IDE）

方式四：在配置文件中引用

根据你使用的工具，在对应配置文件中引用 skills：

详细安装指南：Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent · Qoder · CodeBuddy · 华为云码道 · Kimi Code · Pi · Cline · Kilo Code · Crush

卸载 / 误装清理（v1.2.1+）

cd /your/project          # 或 cd ~ 如果误装到了主目录
npx superpowers-zh@latest --uninstall

会做这些：

• 删除所有装过的 skill 目录（.claude/skills/、.trae/skills/ 等）
• 删除独立 bootstrap 文件（.trae/rules/superpowers-zh.md、.qoder/rules/superpowers-zh.md、.agents/rules.md）
• 清理追加到 CLAUDE.md / HERMES.md / GEMINI.md / CONVENTIONS.md 里的 superpowers-zh 段，保留你自己写的内容

数据安全说明：v1.2.1 起，安装会把追加内容包在 <!-- superpowers-zh:begin/end --> 哨兵注释之间，卸载按哨兵精确切除。识别不可靠时跳过 + 警告，绝不会误删用户内容。

其他参数：

贡献

欢迎参与！翻译改进、新增 skills、Bug 修复都可以。

贡献方向

我们只接收符合 superpowers 定位的 skill——AI 编程工作流方法论。好的 skill 应该：

• 教 AI 助手怎么干活，而不是某个框架/语言的教程
• 解决上游英文版不覆盖的中国开发者痛点
• 有明确的步骤、检查清单、示例，AI 加载后能直接执行

欢迎提 Issue 讨论你的想法！

交流 · Community

微信扫码关注

微信公众号 「AI不止语」（微信搜索 AI_BuZhiYu）— 技术问答 · 项目更新 · 实战文章 渠道 加入方式 QQ 2群 点击加入（群号 1071280067） 微信群 关注公众号后回复「群」获取入群方式

🌟 相关项目生态

八个项目组合使用，覆盖 AI 编程 + AI 视频创作 + 桌面陪伴的完整链路。

项目	定位	一句话
superpowers-zh（本项目）	🧠 工作方法论	20 个 skills 教 AI 怎么干活（TDD / 调试 / 代码审查等）
agency-agents-zh	🎭 专家角色库	211 个即插即用 AI 专家，含 46 中国原创（小红书 / 抖音 / 飞书 / 钉钉）
agency-orchestrator	🚀 编排引擎	一句话 → 211 专家协作，几分钟出方案（9 家 LLM / 6 免费）
ai-coding-guide	📖 实战教程	66 个 Claude Code 技巧 + 9 款工具最佳实践 + 配置模板
shellward	🛡️ 安全中间件	8 层防御 + DLP 数据流 + 注入检测，零依赖（含 MCP Server）
🆕 ai-shortfilm-prompts	🎬 视频提示词	Mx-Shell《丧尸清道夫》5 段式方法论 + Skill，Seedance / 小云雀 / Sora / 可灵 / 即梦通用
🆕 local-agent-toolkit	🛠️ Agent 本地三件套	给 agent 配上记忆 / 技能管理 / 运行追踪，零依赖、数据不出本机；本仓库 skills 可用 npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名称> 一键安装
🆕 codepet	🐾 桌面养成桌宠	码宠 CodePet —— 你写代码 / 用 Claude Code，它就涨经验、升级、换状态、跳舞。全本地、隐私优先、开源

🔥 重点推荐：agency-orchestrator — 一句话调度 211 个 AI 专家协作，几分钟交付完整方案

以前写个方案：你当指挥官，把 AI 轮流扮演 5 个角色，复制粘贴 10 次，1 小时没了。

现在： 丢一句话进去 "做一个电商退款流程"，产品 → 架构 → 安全 → 测试 → DBA 自动接力，几分钟完整方案落地。

• 🎭 211+ 专家角色（含 46 个中国市场原创：小红书 / 抖音 / 微信 / 飞书 / 钉钉）
• 🧩 零代码 YAML，一行 prompt 就能跑
• 💰 9 家 LLM 可选（DeepSeek / Claude / OpenAI / Ollama 等，6 家免费）
• 🔗 与 superpowers-zh 互补：本项目管"怎么做"（方法论），orchestrator 管"谁来做"（角色协作）

👉 立即体验 agency-orchestrator →

致谢

• 原始英文版：obra/superpowers（MIT 协议）
• 感谢 @obra 创建了这个优秀的项目

许可证

MIT License — 自由使用，商业或个人均可。