superpowers-zh README

The project's README from github.com/jnMetaCode/superpowers-zh. As one markdown file: README.md.

superpowers-zh(AI 编程超能力 · 中文增强版)

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

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

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

官网 sp.aiolaola.com GitHub stars npm version License: MIT PRs Welcome

📖 免费配套学习 → 从零学会 AI 编程(182 节)+ 从零构建 AI 智能体(40 节):两门免费实操课 + 实战社区,superpowers 装好后配上方法论效率翻倍(站上共 13 门课、648 节,全部 ¥0——另有 AI 绘画 / 写小说 / 漫剧 / 量化 / DeepSeek / 深度专注 等)

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

📊 项目规模

📦 翻译 Skills 🇨🇳 中国原创 Skills 🤖 支持工具
14 4
另有 2 个上游历史保留
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

❤️ 赞助商  🙏 想出现在这里?联系 [email protected] 赞助

Infistar.cc 无限星河 —— 全模型 API 服务,一个 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek,价格低至官方渠道 1 折

superpowers-zh × Infistar.cc 无限星河|全模型 API · 为 AI 编程注入稳定动力

感谢 Infistar.cc 无限星河 赞助并为 superpowers-zh 用户提供模型服务支持!

🎁 superpowers-zh 用户专属福利:通过此链接注册并完成首次调用,即可领取 5 美元等值测试额度!


优云智算 by UCloud — 热门国产模型按次调用套餐包,低至 49 元/月起

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

Cubence — 专业 AI API 网关,稳定高效的 API 中转服务,支持 Claude Code、Codex、Gemini 等多种模型

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

APIMart —— 专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张

感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,🎁 通过此链接注册即可开用!


这是什么?

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

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

没装 superpowers-zh:

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

装了 superpowers-zh:

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

🆚 与英文上游的区别(老被问,一次说清)

维度 superpowers(英文上游) superpowers-zh(中文增强版)
⭐ Star 数 250k+ —
📦 Skills 总数 14 20(14 翻译 + 4 国产原创 + 2 上游历史保留)
🌐 语言 英文 中文(技术术语保留英文)
🤖 支持工具 6 款:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI 26 款:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy(腾讯) / CodeArts(华为云码道) / Cline / Kilo Code / Crush / ZCode(智谱)/ DeepSeek Harness / Reasonix
⚡ 安装方式 按工具分别装(每款一条不同的 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

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

🤖 支持 26 款主流 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/(全局 ~/.codeium/windsurf/skills/)
Kiro IDE npx superpowers-zh .kiro/skills/
Gemini CLI CLI npx superpowers-zh .gemini/skills/
Codex CLI CLI npx superpowers-zh .agents/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/ + .github/instructions/
DeerFlow 2.0 Agent 框架 npx superpowers-zh skills/custom/
OpenCode CLI npx superpowers-zh .opencode/skills/
OpenClaw CLI npx superpowers-zh skills/
Qwen Code CLI npx superpowers-zh .qwen/skills/ + QWEN.md
Antigravity IDE 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/
ZCode (智谱 ADE) IDE npx superpowers-zh --global --tool zcode ~/.zcode/skills/(仅全局,项目级路径官方未公开)
DeepSeek Harness (dsh) CLI npx superpowers-zh .dsh/skills/ + AGENTS.md
Reasonix CLI npx superpowers-zh .reasonix/skills/ + REASONIX.md(全局 Windows 为 %APPDATA%\reasonix\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(4 个)· 上游历史保留(2 个)

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

⚠️ 表格最后两个(mcp-builder / workflow-runner)不是中国原创 —— 它们来自上游,上游后来移除了,本 fork 保留下来继续维护。全仓 20 个 skill = 14 翻译 + 4 中国原创 + 2 上游历史保留。

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 · CodeBuddy · CodeArts · ZCode · DeepSeek Harness · Reasonix。其中 Codex CLI 全局装到 ~/.agents/skills(Codex 启动扫描目录);Crush 在 Windows 上装到 %LOCALAPPDATA%\crush\skills(其 README 明确 Windows 走这里,不是 ~/.config)。其余工具(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 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 一款工具。要装给其余 25 款工具,仍然用方式一的 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 / Cur

superpowers-zh (jnMetaCode/superpowers-zh)

Searching Database…

What is this?The Chinese community edition of superpowers — a skills framework for AI coding tools. It installs 20 battle-tested workflow skills (brainstorming, planning, TDD, debugging, code review) into 26 AI coding agents so they follow proven work methods.
Is this an app I run, or something I add to my projects?Neither — it's a plugin package: skill files plus SessionStart hooks and bootstrap files that get copied into each AI tool's skills directory, like .claude/skills/ for Claude Code or .cursor/skills/ for Cursor.
How do I install it into my AI coding tool?Run npx superpowers-zh in your project — it auto-detects which of the 26 supported tools you use and installs the 20 skills to the right folders. Use --tool to pick one explicitly or --global to install once for all projects. Don't run the project-level install inside your home directory.
Do I need Node.js or anything else before installing?Just Node.js 20 or newer to run the npx installer — beyond that it only writes skill files that your AI coding tool picks up on its own.
Is manually copying the skills folder just as good as the installer?No — the README calls a manual cp -r a low-fidelity install: a plain copy skips the SessionStart hooks and bootstrap files that make skills auto-trigger. Older versions also polluted your home directory if the installer ran there; since v1.2.1 it refuses.
Does it work on Windows, or only on Mac and Linux?All three desktop systems are covered, wherever your AI tool runs. The docs spell out user-level paths for macOS and Linux (like ~/.claude/skills) and Windows-specific ones — Crush, for example, installs to a LOCALAPPDATA folder on Windows.
How is it different from the English superpowers project?Upstream ships 14 English skills for 6 tools. This edition translates all of them, supports 26 tools, adds 4 China-specific skills, adapts to Chinese git platforms (Gitee, Coding, Jihu GitLab, CNB) and code-review culture, and welcomes new skill PRs — upstream generally doesn't.
Which AI coding tools does it actually support?26 in total: Claude Code, Cursor, Codex CLI, Gemini CLI, Copilot CLI, Windsurf, Kiro, Aider, Trae, VS Code (Copilot), OpenCode, OpenClaw, Qwen Code, Antigravity, Hermes Agent, DeepSeek Harness, Crush, Cline, plus Chinese tools like Qoder, CodeBuddy and Huawei's CodeArts.
What are the four original China-specific skills?chinese-code-review (review etiquette for Chinese teams), chinese-git-workflow (Gitee/Coding/Jihu GitLab/CNB), chinese-documentation (Chinese typography and mixed CN-EN style) and chinese-commit-conventions. They load only when you explicitly type /chinese-xxx, so they never hijack the auto-triggered workflow skills.
What do the translated skills cover?The full development loop: brainstorming into design specs, writing and executing plans, strict test-driven development, four-phase systematic debugging, requesting and receiving code review, verification before claiming done, git worktrees, and parallel or subagent-driven development.
Can I install it through the Claude Code plugin marketplace instead?Yes — that route is managed by the plugin system, and upgrades become a single claude plugin update. Just don't install both ways in the same project, or the skills end up duplicated.
Will this fork drift out of sync with upstream?It tracks upstream releases and layers the China-specific additions on top. The two increments inside translated skills are explicitly marked in the text, and the repo's audit forces an error if any increment is unlabeled.
Creator
jnMetaCode
Size
5 MB
Stars
8.3K
Age
6mo
Commits · 90 Days