Skip to content
Back to search

superpowers-zh

MarketplaceWorks with Claude CodeGitHub

AI 编程超能力中文增强版:21 个 skills,支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jnmetacode-superpowers-zh/badge.svg)](/listings/jnmetacode-superpowers-zh)

HTML

<a href="/listings/jnmetacode-superpowers-zh"><img src="/api/listings/jnmetacode-superpowers-zh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines
  1. {
  2. "name": "superpowers-zh",
  3. "description": "AI 编程超能力中文增强版:21 个 skills,支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
  4. "owner": {
  5. "name": "jnMetaCode",
  6. "url": "https://github.com/jnMetaCode"
  7. },
  8. "plugins": [
  9. {
  10. "name": "superpowers-zh",
  11. "description": "AI 编程超能力中文增强版:21 个 skills(15 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
  12. "version": "1.9.1",
  13. "source": "./",
  14. "author": {
  15. "name": "jnMetaCode",
  16. "url": "https://github.com/jnMetaCode"
  17. }
  18. }
  19. ]
  20. }
README.md · README · 524 lines
  1. # superpowers-zh(AI 编程超能力 · 中文增强版)
  2. 🌐 **简体中文** | [繁體中文](README.zh-Hant.md) | [English (upstream)](https://github.com/obra/superpowers)
  3. > 🦸 **superpowers(300k+ ⭐)完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
  4. Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 21 skills across 26 AI coding tools, including full translations and China-specific development skills.
  5. [![官网 sp.aiolaola.com](https://img.shields.io/badge/🌐_官网-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com)
  6. [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
  7. [![npm version](https://img.shields.io/npm/v/superpowers-zh)](https://www.npmjs.com/package/superpowers-zh)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  9. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
  10. > 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)(182 节)+ [从零构建 AI 智能体](https://aiolaola.com/course/ai-agent?utm_source=github&utm_campaign=superpowers)(40 节):两门免费实操课 + 实战社区,superpowers 装好后配上方法论效率翻倍(站上共 14 门课、700 节,**全部 ¥0**——另有 大模型原理 / AI 绘画 / 写小说 / 漫剧 / 量化 / DeepSeek / 深度专注 等)
  11. >
  12. > 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers)
  13. > 🧠 **新:让 Claude Code / Codex / Cursor / Gemini CLI 不再失忆** → [engram](https://github.com/jnMetaCode/engram):一条 `npx @jnmetacode/engram install`,自动记住每次会话问过什么、改了哪些文件、最后怎么解决的,下次开会话自动带回(带出处)。**记忆跨工具共享**——Codex 里定的事,Claude Code 也知道。全本地、零依赖、中文友好。
  14. ### 📊 项目规模
  15. | 📦 翻译 Skills | 🇨🇳 中国原创 Skills | 🤖 支持工具 |
  16. |:---:|:---:|:---:|
  17. | **15** | **4**<br><sub>另有 2 个上游历史保留</sub> | **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** |
  18. ---
  19. ## ❤️ 赞助商 &nbsp;<sub>🙏 想出现在这里?联系 **jnMetaCode@qq.com** 赞助</sub>
  20. <p align="center">
  21. <a href="https://apinebula.ai/1Axi9F">
  22. <img src="assets/sponsors/apinebula.png" alt="APINEBULA —— 企业级 AI 聚合平台,一个接口接入 Claude、GPT、Gemini 等全球顶尖模型,价格低至 1 折" width="100%">
  23. </a>
  24. </p>
  25. 感谢 [APINEBULA](https://apinebula.ai/1Axi9F) 大屏赞助本项目!APINEBULA 是银河录像局旗下的企业级 AI 聚合平台,背靠大平台资源,面向开发者、团队与企业用户提供稳定、高性价比的大模型 API 接入服务。平台聚合 Claude、GPT、Gemini 等主流满血模型,一个接口接入全球顶尖 AI 大模型,各大模型价格低至 1 折起,支持企业级高并发、正式合同、对公打款与开票服务,适合 AI 编程、Agent 开发、业务系统集成等多种场景!
  26. 🎁 **通过[此链接](https://apinebula.ai/1Axi9F)注册并在充值时填写 `agent` 优惠码可享 9 折优惠!**
  27. <hr>
  28. <table>
  29. <tr>
  30. <td width="25%">
  31. <a href="https://apixo.ai/zh?utm_source=github&utm_medium=sponsorship&utm_campaign=superpowers&utm_content=logo" target="_blank">
  32. <img src="assets/sponsors/apixo-ai-card-450x250.png" alt="APIXO AI: 一站式 AI 视频制作与多模态创作平台 | 黑五特惠" width="100%">
  33. </a>
  34. </td>
  35. <td width="75%" valign="middle">
  36. **[APIXO AI](https://apixo.ai/zh?utm_source=github&utm_medium=sponsorship&utm_campaign=superpowers&utm_content=brand_mention):一站式 AI 视频制作与多模态创作平台**
  37. 全方位赋能日常效率与创意工作流,支持 4K 超清视频生成、Seedream 5.5 电影感出图(低至 $0.014/张起)及 Suno 音乐创作。
  38. 全面支持 **[MCP 协议一键集成](https://apixo.ai/zh/mcp?utm_source=github&utm_medium=sponsorship&utm_campaign=superpowers&utm_content=mcp_page)**,国内开发者免海外卡即开即用。黑五专属福利全面开启!
  39. 🔥 **[立即查看 APIXO 黑五特惠活动,最高立省 40% →](https://apixo.ai/zh/deals/black-friday?utm_source=github&utm_medium=sponsorship&utm_campaign=superpowers&utm_content=black_friday)**
  40. </td>
  41. </tr>
  42. </table>
  43. <table>
  44. <tr>
  45. <td width="25%">
  46. <a href="https://88api.ai/sign-up?aff=MvTX">
  47. <img src="assets/sponsors/88api.jpg" alt="88API Token聚合平台 —— 聚合语言、编程、图片、视频与语音模型的一站式 AI API 平台" width="100%">
  48. </a>
  49. </td>
  50. <td width="75%" valign="middle">
  51. [88API Token聚合平台](https://88api.ai/sign-up?aff=MvTX)<br>
  52. 🧠 聚合 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等语言与编程模型;<br>
  53. 🎨 图片模型:GPT-Image、Gemini、Grok 等;<br>
  54. 🎬 视频模型:Seedance、Veo、MiniMax H3、Kling、Grok 等;<br>
  55. 🎙️ 语音能力:Whisper、TTS 等。从文案、出图、改图,到视频生成与配音<br>
  56. 🎁新用户注册送体验额度,可以检测模型能力。站内有人工客服值守!<br>
  57. 👉香港正规企业运营 稳定供应 全绿满血 不降智 提供发票
  58. </td>
  59. </tr>
  60. </table>
  61. <table>
  62. <tr>
  63. <td width="25%">
  64. <a href="https://cubence.com/signup?code=SCW29JP9">
  65. <img src="assets/sponsors/cubence.jpg" alt="Cubence — 专业 AI API 网关,稳定高效的 API 中转服务,支持 Claude Code、Codex、Gemini 等多种模型" width="100%">
  66. </a>
  67. </td>
  68. <td width="75%" valign="middle">
  69. 感谢 [Cubence](https://cubence.com/signup?code=SCW29JP9) 对本项目的支持。Cubence 是一家致力为客户提供稳定、高效的 API 中转服务商。从 25 年 9 月运营至今,提供了 Claude Code、Codex、Gemini 等多种模型支持。🎁 **Cubence 为本开源项目的用户提供了特别的专属优惠码 `AGENCY`,通过[此链接](https://cubence.com/signup?code=SCW29JP9)注册的用户,首次购买即可享受 9 折优惠!**
  70. </td>
  71. </tr>
  72. </table>
  73. <table>
  74. <tr>
  75. <td width="25%">
  76. <a href="https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw">
  77. <img src="assets/sponsors/volcengine.png" alt="字节火山引擎 —— 火山方舟 Agent/Coding Plan 国模套餐首购 9.9,注册免费领 2500w Token" width="100%">
  78. </a>
  79. </td>
  80. <td width="75%" valign="middle">
  81. 感谢 [字节火山引擎](https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw) 赞助本项目!火山方舟 Agent/Coding Plan 国模套餐首购 **9.9**,支持 GLM-5.3、Kimi-K3、DeepSeek、MiniMax、Doubao 等,**注册免费领 2500w Token**,统一 API,适配编码与智能体开发。👉 **[立即前往](https://www.volcengine.com/activity/ai618?utm_source=OWO&utm_medium=devrel-1&utm_campaign=hw&utm_term=superpowers-zh&utm_content=hw)**
  82. </td>
  83. </tr>
  84. </table>
  85. ---
  86. ## 这是什么?
  87. [superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架(300k+ stars),为 AI 编程工具提供**系统化的工作方法论**。
  88. **superpowers-zh** 在完整翻译的基础上,新增了面向中国开发者的特色 skills。
  89. <!-- 效果对比 -->
  90. <table>
  91. <tr><td>
  92. **没装 superpowers-zh:**
  93. ```
  94. 你:给用户模块加个批量导出功能
  95. AI:好的,我来实现...(直接开始写代码)
  96. export async function exportUsers() { ... }
  97. 你:等等,格式不对,没分页,大数据量会 OOM...
  98. ```
  99. </td><td>
  100. **装了 superpowers-zh:**
  101. ```
  102. 你:给用户模块加个批量导出功能
  103. AI:在开始实现之前,我需要了解几个关键问题:
  104. 1. 导出格式是 CSV 还是 Excel?
  105. 2. 预计数据量多大?需要异步处理吗?
  106. 3. 有权限要求吗?
  107. → 给出 2-3 个方案,确认后再动手
  108. ```
  109. </td></tr>
  110. </table>
  111. ### 🆚 与英文上游的区别(老被问,一次说清)
  112. | 维度 | superpowers(英文上游) | superpowers-zh(中文增强版) |
  113. |------|----------------------|---------------------------|
  114. | ⭐ Star 数 | 300k+ | — |
  115. | 📦 Skills 总数 | 15 | **21**(15 翻译 + 4 国产原创 + 2 上游历史保留) |
  116. | 🌐 语言 | 英文 | 中文(技术术语保留英文) |
  117. | 🤖 **支持工具** | **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 |
  118. | ⚡ **安装方式** | 按工具分别装(每款一条不同的 plugin marketplace 命令) | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**;识别不出可 `--tool <name>` 显式指定 |
  119. | 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + **CNB(腾讯云原生构建)** |
  120. | 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + `.cnb.yml` |
  121. | 🇨🇳 代码审查风格 | 西方直接风格 | 适配国内团队沟通文化 |
  122. | 🇨🇳 Git 提交规范 | 无 | Conventional Commits 中文适配 |
  123. | 🇨🇳 中文文档规范 | 无 | 中文排版 + 中英混排规则 + 告别机翻味 |
  124. | ➕ MCP 服务器构建 | 无 | 独立 `mcp-builder` skill |
  125. | ➕ 工作流执行器 | 无 | 独立 `workflow-runner` skill(多角色 YAML 编排) |
  126. | ➕ 翻译 skill 内的增量 | — | `using-superpowers` 保留显式标注的「中国特色技能路由」;`brainstorming` 补充「你看着办 / 你定吧」不等于跳过流程的中文语境说明,依据与 eval 范围见 v1.8.0 更新日志。`executing-plans` 原有「常见异常处理」已于 v1.7.14 删除,避免与上游内联执行流程冲突。 |
  127. | 🔄 版本跟进 | 独立迭代 | **同步上游 + 国产增量叠加** |
  128. | 🤝 接受新 skill PR | 一般不接受(原文:*"we don't generally accept contributions of new skills"*) | 欢迎 PR(中国开发者痛点优先) |
  129. | 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
  130. | 📜 License | MIT | MIT |
  131. **一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+** 26 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
  132. ### 🤖 支持 26 款主流 AI 编程工具
  133. | 工具 | 类型 | 一键安装 | 手动安装 |
  134. |------|------|:---:|:---:|
  135. | [Claude Code](https://claude.ai/code) | CLI | `npx superpowers-zh` | `.claude/skills/` |
  136. | [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
  137. | [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --global --tool hermes` | `~/.hermes/skills/` |
  138. | [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
  139. | [Windsurf](https://windsurf.com) | IDE | `npx superpowers-zh` | `.windsurf/skills/`(全局 `~/.codeium/windsurf/skills/`) |
  140. | [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/skills/` |
  141. | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | CLI | `npx superpowers-zh` | `.gemini/skills/` |
  142. | [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.agents/skills/` |
  143. | [Aider](https://aider.chat) | CLI | `npx superpowers-zh` | `.aider/skills/` |
  144. | [Trae](https://trae.ai) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |
  145. | [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` + `.github/instructions/` |
  146. | [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
  147. | [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
  148. | [OpenClaw](https://github.com/openclaw/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
  149. | [Qwen Code](https://github.com/QwenLM/qwen-code) | CLI | `npx superpowers-zh` | `.qwen/skills/` + `QWEN.md` |
  150. | [Antigravity](https://antigravity.google) | IDE | `npx superpowers-zh` | `.agents/skills/` |
  151. | [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |
  152. | [Qoder](https://qoder.com) (阿里 AI IDE) | IDE | `npx superpowers-zh` | `.qoder/skills/` + `.qoder/rules/` |
  153. | [CodeBuddy](https://copilot.tencent.com) (腾讯 AI IDE) | IDE | `npx superpowers-zh` | `.codebuddy/skills/` + `CODEBUDDY.md` |
  154. | [华为云码道 CodeArts](https://codearts.huaweicloud.com/) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` |
  155. | [Cline](https://cline.bot) | IDE 插件 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` |
  156. | [Kilo Code](https://kilo.ai) | IDE 插件 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` |
  157. | [Crush](https://github.com/charmbracelet/crush) | CLI | `npx superpowers-zh` | `.crush/skills/` |
  158. | [ZCode](https://zcode.z.ai/) (智谱 ADE) | IDE | `npx superpowers-zh --global --tool zcode` | `~/.zcode/skills/`(仅全局,项目级路径官方未公开) |
  159. | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) | CLI | `npx superpowers-zh` | `.dsh/skills/` + `AGENTS.md` |
  160. | [Reasonix](https://reasonix.io/) | CLI | `npx superpowers-zh` | `.reasonix/skills/` + `REASONIX.md`(全局 Windows 为 `%APPDATA%\reasonix\skills`) |
  161. > 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具,将 21 个 skills 安装到正确位置。
  162. ### 翻译的 Skills(15 个)
  163. | Skill | 用途 |
  164. |-------|------|
  165. | **头脑风暴** (brainstorming) | 需求分析 → 设计规格,不写代码先想清楚 |
  166. | **编写计划** (writing-plans) | 把规格拆成可执行的实施步骤 |
  167. | **执行计划** (executing-plans) | 按计划逐步实施,每步验证 |
  168. | **测试驱动开发** (test-driven-development) | 严格 TDD:先写测试,再写代码 |
  169. | **系统化调试** (systematic-debugging) | 四阶段调试法:定位→分析→假设→修复 |
  170. | **诊断 Superpowers** (diagnosing-superpowers) | 会话跑偏时读 transcript 取证,每条结论带 `path:line`,可整理成 issue |
  171. | **请求代码审查** (requesting-code-review) | 派遣审查 agent 检查代码质量 |
  172. | **接收代码审查** (receiving-code-review) | 技术严谨地处理审查反馈,拒绝敷衍 |
  173. | **完成前验证** (verification-before-completion) | 证据先行——声称完成前必须跑验证 |
  174. | **派遣并行 Agent** (dispatching-parallel-agents) | 多任务并发执行 |
  175. | **子 Agent 驱动开发** (subagent-driven-development) | 每个任务一个 agent,两轮审查 |
  176. | **Git Worktree 使用** (using-git-worktrees) | 隔离式特性开发 |
  177. | **完成开发分支** (finishing-a-development-branch) | 合并/PR/保留/丢弃四选一 |
  178. | **编写 Skills** (writing-skills) | 创建新 skill 的方法论 |
  179. | **使用 Superpowers** (using-superpowers) | 元技能:如何调用和优先使用 skills |
  180. ### 🇨🇳 中国原创 Skills(4 个)· 上游历史保留(2 个)
  181. > ⚠️ **下表前 4 个 chinese-\* 为「手动调用」skill**——不会自动触发,需在对话中显式输入 `/chinese-xxx` 才会加载。
  182. > 设计为参考资料而非工作流,避免污染上游 skill 的自动调度(如 `requesting-code-review`、`brainstorming` 等)。
  183. >
  184. > ⚠️ **表格最后两个(mcp-builder / workflow-runner)不是中国原创** —— 它们来自上游,上游后来移除了,本 fork 保留下来继续维护。全仓 21 个 skill = 15 翻译 + 4 中国原创 + 2 上游历史保留。
  185. | Skill | 用途 | 调用方式 | 上游有吗? |
  186. |-------|------|---------|:---:|
  187. | **中文代码审查** (chinese-code-review) | 符合国内团队文化的代码审查规范 | `/chinese-code-review`(手动) | 无 |
  188. | **中文 Git 工作流** (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab/CNB | `/chinese-git-workflow`(手动) | 无 |
  189. | **中文技术文档** (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | `/chinese-documentation`(手动) | 无 |
  190. | **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | `/chinese-commit-conventions`(手动) | 无 |
  191. | **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具,扩展 AI 能力边界 | 自动 | 曾有,上游已移除 |
  192. | **工作流执行器** (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 自动 | 曾有,上游已移除 |
  193. ---
  194. ## 快速开始
  195. ### 方式一:npm 安装(推荐)
  196. **项目级**(默认,装到当前项目):
  197. ```bash
  198. cd /your/project
  199. npx superpowers-zh
  200. ```
  201. > ⚠️ **项目级安装不要在主目录(`~`)下跑**。v1.2.1 起会拒绝并提示,老版本会把 skills 和 `CLAUDE.md` 等 bootstrap 文件写到你的 home 目录,污染所有项目。如已误装见下文「卸载 / 误装清理」。想让 skills 对所有项目生效,请用下面的**全局安装**,而不是在 `~` 下跑项目级。
  202. **全局安装**(v1.7.0+,装到用户目录,所有项目共享,适合同时维护多个项目):
  203. ```bash
  204. npx superpowers-zh --global # 自动检测已装工具
  205. npx superpowers-zh --global --tool claude # 或指定工具
  206. ```
  207. 全局安装把 skills 装到工具的**用户级目录**(如 `~/.claude/skills`),一次安装所有项目自动可用,更新时也只需重装一次。**项目级优先、全局兜底**,二者可共存。
  208. 支持通用全局安装的工具(均为 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`。
  209. | | 项目级(默认) | 全局(`--global`) |
  210. |---|---|---|
  211. | 安装位置 | `<项目>/.claude/skills` 等 | `~/.claude/skills` 等用户级目录 |
  212. | 生效范围 | 仅当前项目 | 所有项目 |
  213. | 适合 | 单项目、需项目内版本固定 | 多项目、想一次装好到处可用 |
  214. | 卸载 | `npx superpowers-zh --uninstall` | `npx superpowers-zh --global --uninstall` |
  215. ### 方式二:Claude Code Plugin Marketplace
  216. **仅限 Claude Code。** 走官方 plugin 机制装,好处是升级只要一条 `claude plugin update`,不用重跑 npx:
  217. ```bash
  218. claude plugin marketplace add jnMetaCode/superpowers-zh
  219. claude plugin install superpowers-zh@superpowers-zh
  220. ```
  221. 装完 `claude plugin list` 应该看到:
  222. ```
  223. ❯ superpowers-zh@superpowers-zh
  224. Version: <当前版本>
  225. Scope: user
  226. Status: ✔ enabled
  227. ```
  228. 升级与卸载:
  229. ```bash
  230. claude plugin marketplace update superpowers-zh # 先刷新 marketplace 缓存
  231. claude plugin update superpowers-zh@superpowers-zh # 再升级 plugin(需重启生效)
  232. claude plugin uninstall superpowers-zh@superpowers-zh # 卸载
  233. ```
  234. > **和方式一怎么选?** marketplace 装的是**完整 plugin**(skills + hooks + bootstrap 由 Claude Code 统一托管、随版本更新),但只服务 Claude Code 一款工具。要装给其余 25 款工具,仍然用方式一的 `npx superpowers-zh`。两者可以共存,但同一个项目里别重复装 Claude Code,否则 skills 会出现两份。
  235. ### 方式三:手动安装(low-fidelity,仅作备选)
  236. > ⚠️ **手动 `cp -r skills` 是低保版安装,不等同于完整 plugin。**
  237. >
  238. > superpowers-zh 是一个完整 plugin,包含:`skills/`(21 个能力)+ `hooks/`(SessionStart 钩子,让 skill 在合适时机自动触发)+ `CLAUDE.md` / `GEMINI.md` 等 bootstrap 引导文件 + 4 套 plugin manifest(Claude Code / Cursor / Codex / Marketplace)。
  239. >
  240. > **下面的命令只复制 skill 文件**,不会自动配置 hooks 或生成 bootstrap。是否原生发现 skill、是否还需引导或配置,取决于工具;请按下方专属指南完成配置并在新会话验收,不能仅凭文件存在就判断已生效。
  241. >
  242. > **强烈推荐用方式一 `npx superpowers-zh`** —— 它会按工具处理 skills 复制、所需的 bootstrap / hooks 和工具特定适配。仅在 npx 不可用(极端无网络环境)时才退到手动。
  243. ```bash
  244. # 克隆仓库
  245. git clone https://github.com/jnMetaCode/superpowers-zh.git
  246. # 复制 skills 到你的项目(选择你使用的工具)
  247. mkdir -p /your/project/.claude/skills && cp -R superpowers-zh/skills/. /your/project/.claude/skills/ # Claude Code / Copilot CLI
  248. mkdir -p /your/project/.hermes/skills && cp -R superpowers-zh/skills/. /your/project/.hermes/skills/ # Hermes Agent
  249. mkdir -p /your/project/.cursor/skills && cp -R superpowers-zh/skills/. /your/project/.cursor/skills/ # Cursor
  250. mkdir -p /your/project/.agents/skills && cp -R superpowers-zh/skills/. /your/project/.agents/skills/ # Codex CLI
  251. mkdir -p /your/project/.kiro/skills && cp -R superpowers-zh/skills/. /your/project/.kiro/skills/ # Kiro
  252. mkdir -p /your/project/skills/custom && cp -R superpowers-zh/skills/. /your/project/skills/custom/ # DeerFlow 2.0
  253. mkdir -p /your/project/.trae/skills && cp -R superpowers-zh/skills/. /your/project/.trae/skills/ # Trae
  254. mkdir -p /your/project/.agents/skills && cp -R superpowers-zh/skills/. /your/project/.agents/skills/ # Antigravity
  255. mkdir -p /your/project/.github/superpowers && cp -R superpowers-zh/skills/. /your/project/.github/superpowers/ # VS Code (Copilot)
  256. mkdir -p /your/project/skills && cp -R superpowers-zh/skills/. /your/project/skills/ # OpenClaw
  257. mkdir -p /your/project/.windsurf/skills && cp -R superpowers-zh/skills/. /your/project/.windsurf/skills/ # Windsurf
  258. mkdir -p /your/project/.gemini/skills && cp -R superpowers-zh/skills/. /your/project/.gemini/skills/ # Gemini CLI
  259. mkdir -p /your/project/.aider/skills && cp -R superpowers-zh/skills/. /your/project/.aider/skills/ # Aider
  260. mkdir -p /your/project/.opencode/skills && cp -R superpowers-zh/skills/. /your/project/.opencode/skills/ # OpenCode
  261. mkdir -p /your/project/.qwen/skills && cp -R superpowers-zh/skills/. /your/project/.qwen/skills/ # Qwen Code
  262. mkdir -p /your/project/.claw/skills && cp -R superpowers-zh/skills/. /your/project/.claw/skills/ # Claw Code(Rust 版)
  263. mkdir -p /your/project/.qoder/skills && cp -R superpowers-zh/skills/. /your/project/.qoder/skills/ # Qoder(阿里 AI IDE)
  264. ```
  265. ### 方式四:在配置文件中引用
  266. 根据你使用的工具,在对应配置文件中引用 skills:
  267. | 工具 | 配置文件 | 说明 |
  268. |------|---------|------|
  269. | Claude Code | `CLAUDE.md` | 项目根目录 |
  270. | Copilot CLI | `CLAUDE.md` | 与 Claude Code 共用插件格式 |
  271. | Hermes Agent | `AGENTS.md` + `.hermes/skills/` | 项目级生成 AGENTS.md;还需登记 skills.external_dirs,全局安装及详情见 [Hermes 指南](docs/README.hermes.md) |
  272. | Kiro | `.kiro/steering/superpowers-zh.md`(索引,`inclusion: always`)+ `.kiro/skills/` | steering 每轮常驻,故只放索引 |
  273. | DeerFlow 2.0 | `skills/custom/*/SKILL.md` | 字节跳动开源 SuperAgent,自动发现自定义 skills |
  274. | Trae | `.trae/rules/superpowers-zh.md` + `.trae/skills/` | 安装器生成项目级 bootstrap,skill 文件独立存放 |
  275. | Antigravity | `.agents/rules.md` + `.agents/skills/` | 安装器生成引导规则,不覆盖已有 GEMINI.md / AGENTS.md |
  276. | VS Code | `.github/copilot-instructions.md` | Copilot 自定义指令 |
  277. | Cursor | `.cursor/rules/*.md` | 项目级规则目录 |
  278. | OpenClaw | `skills/*/SKILL.md` | 工作区级 skills 目录,自动发现 |
  279. | Windsurf | `.windsurf/skills/*/SKILL.md` | 项目级 skills 目录 |
  280. | Gemini CLI | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 |
  281. | Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |
  282. | OpenCode | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 |
  283. | Qwen Code | `.qwen/skills/*/SKILL.md` + `QWEN.md` | skills 自动发现;QWEN.md 是官方分层记忆的默认上下文文件 |
  284. | Claw Code | `.claw/skills/*/SKILL.md` | Rust 版 CLI agent,兼容 Claude Code 的 SKILL.md 格式 |
  285. | Qoder | `.qoder/skills/*/SKILL.md` + `.qoder/rules/superpowers-zh.md` | 阿里 AI IDE,自动生成 `trigger: always_on` 的 bootstrap rule |
  286. > **详细安装指南**:[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md) · [Claw Code](docs/README.claw.md) · [Qoder](docs/README.qoder.md) · [CodeBuddy](docs/README.codebuddy.md) · [华为云码道](docs/README.codearts.md) · [Kimi Code](docs/README.kimi.md) · [Pi](docs/README.pi.md) · [Cline](docs/README.cline.md) · [Kilo Code](docs/README.kilocode.md) · [Crush](docs/README.crush.md)
  287. ### 卸载 / 误装清理(v1.2.1+)
  288. ```bash
  289. cd /your/project # 或 cd ~ 如果误装到了主目录
  290. npx superpowers-zh@latest --uninstall
  291. ```
  292. 会做这些:
  293. - 删除所有装过的 skill 目录(`.claude/skills/`、`.trae/skills/` 等)
  294. - 删除独立 bootstrap 文件(`.trae/rules/superpowers-zh.md`、`.qoder/rules/superpowers-zh.md`、`.agents/rules.md`)
  295. - 清理追加到 `CLAUDE.md` / `HERMES.md` / `GEMINI.md` / `CONVENTIONS.md` 里的 superpowers-zh 段,**保留你自己写的内容**
  296. 数据安全说明:v1.2.1 起,安装会把追加内容包在 `<!-- superpowers-zh:begin/end -->` 哨兵注释之间,卸载按哨兵精确切除。识别不可靠时跳过 + 警告,**绝不会误删用户内容**。
  297. 其他参数:
  298. | 参数 | 用途 |
  299. |---|---|
  300. | `--tool <name>` | 自动检测不到时显式指定(cursor / trae / hermes / 等) |
  301. | `--force` | 允许在主目录(~)安装(默认拒绝,**不建议**) |
  302. | `--uninstall` | 卸载当前目录下的 superpowers-zh |
  303. | `--help` / `--version` | 帮助 / 版本 |
  304. > **版本号怎么看?** 旧安装的 skill 可能仍标记 `1.0.0`;v1.9.1 起技能版本随发行版同步,旧安装请重新执行更新命令。`npx superpowers-zh --version` 显示本次运行的安装器版本,也不代表项目此前安装的技能版本。按安装方式核对与更新,见[版本号与安装内容核对](docs/VERSIONING.md)。
  305. ---
  306. SDD 生成英文简报、报告或提交信息时,见[中文产出配置与排查](docs/SDD-LANGUAGE.md)。
  307. ## 贡献
  308. 原生 Hermes / Muse / Antigravity / Devin 渠道及 Codex 发布工具的候选版本状态,见[原生插件与发布验收](docs/NATIVE-PLUGINS.md)。这些新增渠道尚待真实会话验收,不能把 manifest 检查通过当成集成已完成。
  309. 欢迎参与!翻译改进、新增 skills、Bug 修复都可以。
  310. ### 贡献方向
  311. 我们只接收符合 superpowers 定位的 skill——**AI 编程工作流方法论**。好的 skill 应该:
  312. - 教 AI 助手**怎么干活**,而不是某个框架/语言的教程
  313. - 解决上游英文版不覆盖的**中国开发者痛点**
  314. - 有明确的步骤、检查清单、示例,AI 加载后能直接执行
  315. 欢迎提 Issue 讨论你的想法!
  316. ---
  317. ## 交流 · Community
  318. <table>
  319. <tr>
  320. <td width="170" align="center">
  321. <img src="assets/qr-wechat.jpg" width="150" alt="微信公众号 AI不止语 二维码"><br>
  322. <sub>微信扫码关注</sub>
  323. </td>
  324. <td>
  325. 微信公众号 **「AI不止语」**(微信搜索 `AI_BuZhiYu`)— 技术问答 · 项目更新 · 实战文章
  326. | 渠道 | 加入方式 |
  327. |------|---------|
  328. | QQ 2群 | [点击加入](https://qm.qq.com/q/EeNQA9xCxy)(群号 1071280067) |
  329. | 微信群 | 关注公众号后回复「群」获取入群方式 |
  330. </td>
  331. </tr>
  332. </table>
  333. ---
  334. ## 🌟 相关项目生态
  335. **九个项目组合使用,覆盖 AI 编程 + AI 视频创作 + 桌面陪伴的完整链路。**
  336. | 项目 | 定位 | 一句话 |
  337. |------|------|-------|
  338. | **[superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)**(本项目) ![](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=flat&label=⭐) | 🧠 工作方法论 | 21 个 skills 教 AI 怎么干活(TDD / 调试 / 代码审查等) |
  339. | **[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-agents-zh?style=flat&label=⭐) | 🎭 专家角色库 | 277 个**即插即用** AI 专家,含 64 中国原创(小红书 / 抖音 / 飞书 / 钉钉 / Qt 上位机 / 机械设计) |
  340. | **[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator)** ![](https://img.shields.io/github/stars/jnMetaCode/agency-orchestrator?style=flat&label=%E2%AD%90) | 🚀 编排引擎 | 一句话 → 276 专家协作,**几分钟出方案**(15 种大模型 / 11 种免 key) |
  341. | **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 实战教程 | 66 个 Claude Code 技巧 + 10 款工具最佳实践 + 配置模板 |
  342. | **[shellward](https://github.com/jnMetaCode/shellward)** | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测,**零依赖**(含 MCP Server) |
  343. | 🆕 **[ai-shortfilm-prompts](https://github.com/jnMetaCode/ai-shortfilm-prompts)** | 🎬 视频提示词 | Mx-Shell《丧尸清道夫》5 段式方法论 + Skill,Seedance / 小云雀 / Sora / 可灵 / 即梦通用 |
  344. | 🆕 **[local-agent-toolkit](https://github.com/jnMetaCode/local-agent-toolkit)** | 🛠️ Agent 本地三件套 | 给 agent 配上**记忆 / 技能管理 / 运行追踪**,零依赖、数据不出本机;本仓库 skills 可用 `npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名称>` 一键安装 |
  345. | 🆕 **[codepet](https://github.com/jnMetaCode/codepet)** | 🐾 桌面养成桌宠 | 码宠 CodePet —— 你写代码 / 用 Claude Code,它就涨经验、升级、换状态、跳舞。**全本地、隐私优先、开源** |
  346. | 🆕 **[openshorts](https://github.com/jnMetaCode/openshorts)** | 🎥 短视频生产线 | 开片 —— 文案进,成片出:脚本 / 配音 / 字幕 / 成片 / 发布包一条龙,**0 元 0 key 跑通第一条**,本地优先 |
  347. ---
  348. ### 🔥 重点推荐:[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) — 一句话调度 276 个 AI 专家协作,几分钟交付完整方案
  349. 以前写个方案:你当指挥官,把 AI 轮流扮演 5 个角色,复制粘贴 10 次,1 小时没了。
  350. **现在:** 丢一句话进去 `"做一个电商退款流程"`,**产品 → 架构 → 安全 → 测试 → DBA 自动接力**,几分钟完整方案落地。
  351. - 🎭 **276+ 专家角色**(含 64 个中国市场原创:小红书 / 抖音 / 微信 / 飞书 / 钉钉)
  352. - 🧩 **零代码 YAML**,一行 prompt 就能跑
  353. - 💰 **15 种大模型可选**(DeepSeek / Claude / OpenAI / Ollama 等,**11 种免 key**)
  354. - 🔗 **与 superpowers-zh 互补**:本项目管"**怎么做**"(方法论),orchestrator 管"**谁来做**"(角色协作)
  355. 👉 **[立即体验 agency-orchestrator →](https://github.com/jnMetaCode/agency-orchestrator)**
  356. ---
  357. ## 致谢
  358. - 原始英文版:[obra/superpowers](https://github.com/obra/superpowers)(MIT 协议)
  359. - 感谢 [@obra](https://github.com/obra) 创建了这个优秀的项目
  360. ---
  361. ## 许可证
  362. MIT License — 自由使用,商业或个人均可。
  363. ---
  364. ## 📌 最近更新
  365. **已发布 v1.8.0:同步上游 v7.0.0。** 本版重写 brainstorming,并修复 hook、执行账本与官网显示问题。
  366. - **需求澄清**:开放式提问、分块复述;书面设计由 builder check 检查。中文「你看着办」不等于允许跳过流程。
  367. - **执行可靠性**:静默成功的测试正常记账,保留用户已有的 workspace `.gitignore`,修正 Windows hook 和路径处理。
  368. - **官网体验**:修正繁体文案、提示块显示、浅色主题代码块和手机横向溢出。
  369. 完整变更、eval 范围及更新说明见 [v1.8.0 Release Notes](RELEASE-NOTES.zh.md)。旧安装的 `1.0.0` 字段不能用于判断发行版,见[版本核对指南](docs/VERSIONING.md)。
  370. ### v1.7.12 历史修复
  371. > 以下保留 v1.7.12 的历史修复说明;相关修复已包含在后续版本中:
  372. >
  373. > - 🐛 **插件模式下跨技能调用全部失败**([#124](https://github.com/jnMetaCode/superpowers-zh/issues/124))—— 正文照抄了上游的 `superpowers:` 前缀,而本插件叫 `superpowers-zh`,于是 `Skill("superpowers:systematic-debugging")` 返回 Unknown skill。32 处已改为**裸技能名**(两种分发模式都能解析)
  374. > - 🐛 **Crush 在 Windows 上装错目录** —— 官方是 `%LOCALAPPDATA%\crush\skills`,我们两个平台都装 `~/.config`。文档早写对了,代码没跟上
  375. > - 🐛 **render-graphs.js** —— 取上游的安全加固与 Windows 修复,但**不跟它改 ESM**(那会在 Node 20 的普通项目里直接加载失败)
  376. > - 🆕 **新增 DeepSeek Harness 支持**([#122](https://github.com/jnMetaCode/superpowers-zh/issues/122))—— 项目级 `.dsh/skills/` + 全局 `~/.dsh/skills/`,引导写 `AGENTS.md`;四条路径全部有官方出处
  377. > - 🐛 **在管理员 PowerShell 里跑会把 skills 装进 `C:\Windows\System32`**([#125](https://github.com/jnMetaCode/superpowers-zh/issues/125))—— 管理员终端的默认工作目录就是那里。补系统目录护栏,且不提供 `--force` 绕过
  378. > - 🆕 **新增 Reasonix 支持**([#42](https://github.com/jnMetaCode/superpowers-zh/issues/42))—— 项目级 `.reasonix/skills/` + `REASONIX.md`;**Windows 全局是 `%APPDATA%\reasonix\skills`**,与 Unix 不同构
  379. > - 🆕 **新增 ZCode(智谱)支持**(工具数 23 → 26)—— 只做全局安装:官方文档只公开了 `~/.zcode/skills/`,项目级是应用内 UI 导入、不暴露磁盘路径,所以项目级会被明确拒绝而不是猜路径装进去
  380. > - 🛡️ **6 条新门禁**(前缀回归、Windows 路径、卸载不误删用户文件、全局-only 工具项目级必拒、上游漂移计量…),`verify-release` 115 → 144
  381. >
  382. > 📋 官网侧改动(版本提示条、22 份工具文档入口、结构化数据、分享大图、可访问性、sitemap…)见 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
  383. ---
  384. <div align="center">
  385. **🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具真正会干活**
  386. [Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
  387. </div>
  388. ---
  389. ## 📈 Star 趋势
  390. <a href="https://star-history.com/#jnMetaCode/superpowers-zh&Date">
  391. <picture>
  392. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date&theme=dark">
  393. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date">
  394. <img alt="superpowers-zh 的 GitHub Star 增长曲线" src="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date">
  395. </picture>
  396. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.