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…

Что это такое?Китайская редакция проекта superpowers — фреймворка навыков для AI-инструментов для программирования. Он устанавливает 20 проверенных на практике навыков рабочего процесса (мозговой штурм, планирование, TDD, отладка, код-ревью) в 26 AI-агентов для кодинга, чтобы они работали по проверенным методикам.
Это приложение, которое я запускаю, или то, что я добавляю в свои проекты?Ни то, ни другое — это пакет-плагин: файлы навыков плюс SessionStart-хуки и bootstrap-файлы, которые копируются в каталог навыков каждого AI-инструмента, например .claude/skills/ для Claude Code или .cursor/skills/ для Cursor.
Как установить его в мой AI-инструмент для программирования?Запустите npx superpowers-zh в своём проекте — он сам определит, каким из 26 поддерживаемых инструментов вы пользуетесь, и установит 20 навыков в нужные папки. Флаг --tool позволяет выбрать инструмент явно, а --global — установить один раз для всех проектов. Не запускайте установку на уровне проекта в своей домашней директории.
Нужен ли Node.js или что-то ещё перед установкой?Нужен только Node.js 20 или новее, чтобы запустить установщик через npx — дальше он лишь записывает файлы навыков, которые ваш AI-инструмент для кодинга подхватывает сам.
Можно просто вручную скопировать папку навыков — результат будет тот же, что у установщика?Нет — в README ручное копирование через cp -r называется «установкой с потерями»: простое копирование пропускает SessionStart-хуки и bootstrap-файлы, благодаря которым навыки срабатывают автоматически. К тому же старые версии засоряли домашнюю директорию, если установщик запускали там; начиная с v1.2.1 он в такой ситуации отказывается работать.
Он работает на Windows или только на Mac и Linux?Поддерживаются все три настольные системы — везде, где работает ваш AI-инструмент. В документации отдельно указаны пользовательские пути для macOS и Linux (например, ~/.claude/skills) и для Windows — так, Crush на Windows ставится в папку LOCALAPPDATA.
Чем он отличается от английского проекта superpowers?В оригинале — 14 английских навыков для 6 инструментов. Эта редакция переводит их все, поддерживает 26 инструментов, добавляет 4 специфичных для Китая навыка, адаптируется под китайские git-платформы (Gitee, Coding, Jihu GitLab, CNB) и культуру код-ревью, а также принимает PR с новыми навыками — оригинал, как правило, нет.
Какие AI-инструменты для программирования он реально поддерживает?Всего 26: 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, а также китайские инструменты вроде Qoder, CodeBuddy и CodeArts от Huawei.
Что это за четыре оригинальных навыка, специфичных для Китая?chinese-code-review (этикет ревью для китайских команд), chinese-git-workflow (Gitee/Coding/Jihu GitLab/CNB), chinese-documentation (китайская типографика и стиль с участием китайского и английского) и chinese-commit-conventions. Они подгружаются только если вы явно введёте /chinese-xxx, поэтому никогда не перехватывают автоматически срабатывающие навыки рабочего процесса.
Что охватывают переведённые навыки?Весь цикл разработки: от мозгового штурма до спецификаций дизайна, составление и выполнение планов, строгое разработчание через тестирование (TDD), систематическая отладка в четыре фазы, запрос и проведение код-ревью, проверка до того, как объявить работу законченной, git worktrees и параллельная разработка или разработка через субагентов.
Можно установить его через маркетплейс плагинов Claude Code?Да — этот путь управляется системой плагинов, и обновление сводится к одной команде claude plugin update. Только не устанавливайте обоими способами в одном проекте, иначе навыки задублируются.
Не отстанет ли этот форк от оригинала?Он следует за релизами оригинала и добавляет сверху специфичные для Китая расширения. Два дополнения внутри переведённых навыков явно помечены в тексте, а аудит в репозитории выдаёт ошибку, если какое-то дополнение осталось без пометки.
Creator
jnMetaCode
Size
5 MB
Stars
8.3K
Age
6mo
Commits · 90 Days