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 智能体（40 节）：两门免费实操课 + 实战社区，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） |
|
|---|---|---|
| 安 |