superpowers-zh
by jnMetaCode
🦸 AI 编程超能力 · 中文增强版 — superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正会干活
7,018stars
675forks
JavaScript
Added 3/24/2026
AI Agentsagent-skillsagentic-codingai-codingchineseclaude-codecode-reviewcursorgemini-clikiromcpnpm-packageprompt-engineeringskillssuperpowerstddtrae
Installation
# Add to your Claude Code skills
git clone https://github.com/jnMetaCode/superpowers-zhGetting Started
Guides for using ai agents skills like superpowers-zh.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 4/27/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-27T06:28:14.997Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}superpowers-zh（AI 编程超能力 · 中文增强版）
🌐 简体中文 | 繁體中文 | English (upstream)
🦸 superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 20 款 AI 编程工具真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
Chinese community edition of superpowers — 20 skills across 20 AI coding tools, including full translations and China-specific development skills.
📖 免费配套学习 → 从零学会 AI 编程：180 节免费实操课 + 《AI 编程实战三卷书》在线阅读 + 实战社区 · superpowers 装好后配上方法论效率翻倍 · 永久免费
🆕 v1.7.0 更新亮点（完整 Release Notes →）
- 🌍 全局安装
npx superpowers-zh --global—— 一次安装、所有项目共享，多项目党告别逐个重装- 🧩 新增 腾讯 CodeBuddy 与 华为云码道 CodeArts 两款国产 IDE（工具数 18 → 20）
- 🌐 官网 sp.aiolaola.com + README 新增繁体中文（简 / 繁 / EN 三语）
📊 项目规模
| 📦 翻译 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（华为云码道） |
❤️ 赞助商 🙏 想出现在这里？联系 jnMetaCode@qq.com 赞助
这是什么？
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 | 20 款：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） |
| ⚡ 安装方式 | 按工具分别装（每款一条不同的 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 PR | 一般不接受（原文："we don't generally accept contributions of new skills"） | 欢迎 PR（中国开发者痛点优先） |
| 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
| 📜 License | MIT | MIT |
一句话总结： 英文上游 = 方法论内核；中文增强版 = 方法论内核 + 20 款工具一键适配 + 国内 Git/CI 生态 + 中文化表达习惯。
🤖 支持 20 款主流 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 --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/ |
运行
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。其中 Codex CLI 全局装到 ~/.agents/skills（Codex 启动扫描目录）。其余工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw）规则是项目级或存于应用内设置，--global 会提示改用项目级；Gemini CLI / Antigravity 有各自专属的全局方式（Gemini 走扩展目录），见对应 docs/README.*.md。
| 项目级（默认） | 全局（--global） |
|
|---|---|---|
| 安装位置 | <项目>/.claude/skills 等 |
~/.claude/skills 等用户级目录 |
| 生效范围 | 仅当前项目 | 所有项目 |
| 适合 | 单项目、需项目内版本固定 | 多项目、想一次装好到处可用 |
| 卸载 | npx superpowers-zh --uninstall |
npx superpowers-zh --global --uninstall |
方式二：手动安装（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）
Frequently Asked Questions
What is superpowers-zh?
superpowers-zh is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by jnMetaCode. 🦸 AI 编程超能力 · 中文增强版 — superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正会干活. It has 7,018 GitHub stars.
Is superpowers-zh safe to use?
Yes. superpowers-zh passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install superpowers-zh?
Clone the repository with "git clone https://github.com/jnMetaCode/superpowers-zh" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is superpowers-zh written in?
superpowers-zh is primarily written in JavaScript. It is open-source under jnMetaCode on GitHub, so you can review or fork the full source.
Are there alternatives to superpowers-zh?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh superpowers-zh against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
230,983
35,243
JavaScript
AI Agentsai-agentsanthropic
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
196,992
59,454
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
120,031
19,897
Shell
AI Agents