superpowers-zh
AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具
pinned to #b72378bupdated 2 weeks ago
Ask your AI client: “install plugins/superpowers-zh”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install plugins/superpowers-zhmetahub onboarded this repo on the author's behalf.
If you own github.com/jnMetaCode/superpowers-zh on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
6,726
Last commit
2 weeks ago
Latest release
published
- #agent-skills
- #agentic-coding
- #ai-coding
- #chinese
- #claude-code
- #code-review
- #cursor
- #gemini-cli
- #kiro
- #mcp
- #npm-package
- #prompt-engineering
- #skills
- #superpowers
- #tdd
- #trae
What's bundled
Items extracted from this plugin's manifest + directory tree.
Skills (20)
skills/brainstorming在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。skills/chinese-code-review中文 review 沟通参考——话术模板、分级标注（必须修复/建议修改/仅供参考）、国内团队常见反模式应对。仅在用户显式 /chinese-code-review 时调用，不要根据上下文自动触发。skills/chinese-commit-conventions中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用，不要根据上下文自动触发。skills/chinese-documentation中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式 /chinese-documentation 时调用，不要根据上下文自动触发。skills/chinese-git-workflow国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用，不要根据上下文自动触发。skills/dispatching-parallel-agents当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用skills/executing-plans当你有一份书面实现计划需要在单独的会话中执行，并设有审查检查点时使用skills/finishing-a-development-branch当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾
Hooks (1)
- hooks-cursor
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.b72378b· 2 weeks ago
Documentation
22Description quality
55 words · 120 chars — "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Age…"
README is present and substantialwarn
README present but its contents couldn't be read this scan
Transient fetch issue — re-run the eval to grade the README's substance.
Tags / topics declaredwarn
No manifest tags and no GitHub repo topics
Add tags to the manifest (or GitHub topics on the repo) so the registry's search and category filters surface this artifact.
Homepage / docs URL declared
https://github.com/jnMetaCode/superpowers-zh
Release history
1- releasecurrentb72378bwarn2 weeks ago
Contents
🌐 简体中文 | English (upstream)
🦸 superpowers（233k+ ⭐）完整汉化 + 4 个中国原创 skills — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 18 款 AI 编程工具真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
Chinese community edition of superpowers — 20 skills across 18 AI coding tools, including full translations and China-specific development skills.
📖 免费配套学习 → 从零学会 AI 编程：180 节免费实操课 + 《AI 编程实战三卷书》在线阅读 + 实战社区 · superpowers 装好后配上方法论效率翻倍 · 永久免费
📊 项目规模
| 📦 翻译 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 |
❤️ 赞助商 <sub>🙏 想出现在这里？联系 [email protected] 赞助</sub>
<table> <tr> <td width="200" align="center"> [](https://www.5cookie.cc/sign-up?aff=Pj7u) </td> <td> [<b>5Cookie Code</b>](https://www.5cookie.cc/sign-up?aff=Pj7u) 是一家稳定高速的 API 中继服务提供商，为 Claude Code、Codex 等平台或模型提供 API 中继服务。面向个人、团队和企业用户提供 AI 编码服务和 AI 生图服务。 </td> </tr> </table>这是什么？
superpowers 是目前最火的 AI 编程 skills 框架（233k+ stars），为 AI 编程工具提供系统化的工作方法论。
superpowers-zh 在完整翻译的基础上，新增了面向中国开发者的特色 skills。
<table> <tr><td>没装 superpowers-zh：
你：给用户模块加个批量导出功能
AI：好的，我来实现...（直接开始写代码）
export async function exportUsers() { ... }
你：等等，格式不对，没分页，大数据量会 OOM...
装了 superpowers-zh：
你：给用户模块加个批量导出功能
AI：在开始实现之前，我需要了解几个关键问题：
1. 导出格式是 CSV 还是 Excel？
2. 预计数据量多大？需要异步处理吗？
3. 有权限要求吗？
→ 给出 2-3 个方案，确认后再动手
🆚 与英文上游的区别（老被问，一次说清）
| 维度 | superpowers（英文上游） | superpowers-zh（中文增强版） |
|---|---|---|
| ⭐ Star 数 | 233k+ | — |
| 📦 Skills 总数 | 14 | 20（14 翻译 + 4 国产原创 + 2 上游历史保留） |
| 🌐 语言 | 英文 | 中文（技术术语保留英文） |
| 🤖 支持工具 | 6 款：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | 18 款：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder |
| ⚡ 安装方式 | 按工具分别装（每款一条不同的 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 |
一句话总结： 英文上游 = 方法论内核；中文增强版 = 方法论内核 + 18 款工具一键适配 + 国内 Git/CI 生态 + 中文化表达习惯。
🤖 支持 18 款主流 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/ |
运行
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 目录，污染所有项目。如已误装见下文「卸载 / 误装清理」。
方式二：手动安装（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：
| 工具 | 配置文件 | 说明 |
|---|---|---|
| Claude Code | CLAUDE.md | 项目根目录 |
| Copilot CLI | CLAUDE.md | 与 Claude Code 共用插件格式 |
| Hermes Agent | HERMES.md 或 .hermes.md | 项目根目录，安装时自动生成 |
| Kiro | .kiro/steering/*.md | 支持 always/globs/手动三种模式 |
| DeerFlow 2.0 | skills/custom/*/SKILL.md | 字节跳动开源 SuperAgent，自动发现自定义 skills |
| Trae | .trae/rules/project_rules.md | 项目级规则 |
| Antigravity | GEMINI.md 或 AGENTS.md | 项目根目录 |
| VS Code | .github/copilot-instructions.md | Copilot 自定义指令 |
| Cursor | .cursor/rules/*.md | 项目级规则目录 |
| OpenClaw | skills/*/SKILL.md | 工作区级 skills 目录，自动发现 |
| Windsurf | .windsurf/skills/*/SKILL.md | 项目级 skills 目录 |
| Gemini CLI | .gemini/skills/*/SKILL.md | 项目级 skills 目录 |
| Aider | .aider/skills/*/SKILL.md | 项目级 skills 目录 |
| OpenCode | .opencode/skills/*/SKILL.md | 项目级 skills 目录 |
| Hermes Agent | .hermes/skills/*/SKILL.md | 项目级 skills 目录 |
| Qwen Code | .qwen/skills/*/SKILL.md | 项目级 skills 目录 |
| Claw Code | .claw/skills/*/SKILL.md | Rust 版 CLI agent，兼容 Claude Code 的 SKILL.md 格式 |
| Qoder | .qoder/skills/*/SKILL.md + .qoder/rules/superpowers-zh.md | 阿里 AI IDE，自动生成 trigger: always_on 的 bootstrap rule |
详细安装指南：Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent · Qoder · Kimi Code · Pi
卸载 / 误装清理（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 --> 哨兵注释之间，卸载按哨兵精确切除。识别不可靠时跳过 + 警告，绝不会误删用户内容。
其他参数：
| 参数 | 用途 |
|---|---|
--tool <name> | 自动检测不到时显式指定（cursor / trae / hermes / 等） |
--force | 允许在主目录(~)安装（默认拒绝，不建议） |
--uninstall | 卸载当前目录下的 superpowers-zh |
--help / --version | 帮助 / 版本 |
贡献
欢迎参与！翻译改进、新增 skills、Bug 修复都可以。
贡献方向
我们只接收符合 superpowers 定位的 skill——AI 编程工作流方法论。好的 skill 应该：
- 教 AI 助手怎么干活，而不是某个框架/语言的教程
- 解决上游英文版不覆盖的中国开发者痛点
- 有明确的步骤、检查清单、示例，AI 加载后能直接执行
欢迎提 Issue 讨论你的想法！
交流 · Community
<table> <tr> <td width="170" align="center"> <sub>微信扫码关注</sub>
</td> <td>微信公众号 「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 管"谁来做"（角色协作）
致谢
- 原始英文版：obra/superpowers（MIT 协议）
- 感谢 @obra 创建了这个优秀的项目
许可证
MIT License — 自由使用，商业或个人均可。
🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具真正会干活
Reviews
No reviews yet. Be the first.
Related
before-you-build
Production-ready workflow orchestration with 91 marketplace plugins, 199 local specialized agents, and 162 local skills - optimized for granular installation and minimal token usage
explanatory-output-style
Adds educational insights about implementation choices and codebase patterns (mimics the deprecated Explanatory output style)
serena
Semantic code analysis MCP server providing intelligent code understanding, refactoring suggestions, and codebase navigation through language server protocol integration.
mh install plugins/superpowers-zh