superpowers-zh 1.7.10 → 1.7.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.cursor-plugin/plugin.json +2 -2
  5. package/CLAUDE.md +1 -1
  6. package/README.md +87 -39
  7. package/README.zh-Hant.md +86 -38
  8. package/RELEASE-NOTES.zh.md +352 -0
  9. package/assets/og-image.jpg +0 -0
  10. package/assets/sponsors/apimart.jpg +0 -0
  11. package/assets/sponsors/infistar.jpg +0 -0
  12. package/assets/sponsors/logo-apimart-icon.png +0 -0
  13. package/assets/sponsors/logo-compshare-icon.png +0 -0
  14. package/assets/sponsors/logo-cubence-icon.png +0 -0
  15. package/bin/superpowers-zh.js +539 -36
  16. package/docs/README.claw.md +96 -0
  17. package/docs/README.codearts.md +1 -1
  18. package/docs/README.codebuddy.md +16 -3
  19. package/docs/README.codex.md +23 -0
  20. package/docs/README.deepseek-harness.md +56 -0
  21. package/docs/README.deerflow.md +53 -28
  22. package/docs/README.hermes.md +5 -3
  23. package/docs/README.openclaw.md +1 -1
  24. package/docs/README.qwen.md +66 -33
  25. package/docs/README.reasonix.md +57 -0
  26. package/docs/README.vscode.md +29 -20
  27. package/docs/README.windsurf.md +26 -4
  28. package/docs/README.zcode.md +56 -0
  29. package/gemini-extension.json +1 -1
  30. package/package.json +2 -2
  31. package/skills/brainstorming/SKILL.md +69 -18
  32. package/skills/brainstorming/visual-companion.md +9 -0
  33. package/skills/executing-plans/SKILL.md +3 -3
  34. package/skills/finishing-a-development-branch/SKILL.md +21 -0
  35. package/skills/requesting-code-review/code-reviewer.md +8 -0
  36. package/skills/subagent-driven-development/SKILL.md +33 -19
  37. package/skills/subagent-driven-development/implementer-prompt.md +4 -0
  38. package/skills/subagent-driven-development/re-review-prompt.md +4 -0
  39. package/skills/subagent-driven-development/task-reviewer-prompt.md +19 -0
  40. package/skills/systematic-debugging/SKILL.md +2 -2
  41. package/skills/test-driven-development/writing-good-tests.md +1 -1
  42. package/skills/using-superpowers/SKILL.md +7 -7
  43. package/skills/using-superpowers/references/codex-tools.md +53 -2
  44. package/skills/using-superpowers/references/copilot-tools.md +1 -1
  45. package/skills/using-superpowers/references/gemini-tools.md +2 -2
  46. package/skills/using-superpowers/references/hermes-tools.md +55 -42
  47. package/skills/using-superpowers/references/qoder-tools.md +1 -1
  48. package/skills/writing-plans/SKILL.md +10 -3
  49. package/skills/writing-skills/SKILL.md +4 -4
  50. package/skills/writing-skills/render-graphs.js +12 -4
  51. package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "superpowers-zh",
3
- "description": "AI 编程超能力中文增强版:20 个 skills,支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具",
3
+ "description": "AI 编程超能力中文增强版:20 个 skills,支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
4
4
  "owner": {
5
5
  "name": "jnMetaCode",
6
6
  "url": "https://github.com/jnMetaCode"
@@ -8,8 +8,8 @@
8
8
  "plugins": [
9
9
  {
10
10
  "name": "superpowers-zh",
11
- "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具",
12
- "version": "1.7.10",
11
+ "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
12
+ "version": "1.7.12",
13
13
  "source": "./",
14
14
  "author": {
15
15
  "name": "jnMetaCode",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "superpowers-zh",
3
- "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具",
4
- "version": "1.7.10",
3
+ "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
4
+ "version": "1.7.12",
5
5
  "author": {
6
6
  "name": "jnMetaCode",
7
7
  "url": "https://github.com/jnMetaCode"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "superpowers-zh",
3
- "version": "1.7.10",
3
+ "version": "1.7.12",
4
4
  "description": "AI 编程超能力中文增强版:头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流,附 4 个中文 skills 沉淀。",
5
5
  "author": {
6
6
  "name": "jnMetaCode",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "superpowers-zh",
3
3
  "displayName": "Superpowers 中文版",
4
- "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 23 款工具",
5
- "version": "1.7.10",
4
+ "description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 26 款工具",
5
+ "version": "1.7.12",
6
6
  "author": {
7
7
  "name": "jnMetaCode",
8
8
  "url": "https://github.com/jnMetaCode"
package/CLAUDE.md CHANGED
@@ -109,7 +109,7 @@ Skill 不是普通文档 —— 它是塑造 agent 行为的代码。如果你
109
109
 
110
110
  ## 关于本中文 fork(superpowers-zh)
111
111
 
112
- 本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**,定位为:完整翻译上游 skill + 叠加 4 个中国原创 skill(chinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow)+ 多工具适配(npx 一条命令支持 23 款 IDE/CLI)。
112
+ 本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**,定位为:完整翻译上游 skill + 叠加 4 个中国原创 skill(chinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow)+ 多工具适配(npx 一条命令支持 26 款 IDE/CLI)。
113
113
 
114
114
  **上述规则适用于向 `obra/superpowers` 上游提 PR 时的行为约束。** 向中文 fork 提 PR 时按本仓库自己的 PR 模板与流程执行,但其中的核心原则**同样适用**:
115
115
 
package/README.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  🌐 **简体中文** | [繁體中文](README.zh-Hant.md) | [English (upstream)](https://github.com/obra/superpowers)
4
4
 
5
- > 🦸 **superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **23 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
5
+ > 🦸 **superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
6
6
 
7
- Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 23 AI coding tools, including full translations and China-specific development skills.
7
+ Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 26 AI coding tools, including full translations and China-specific development skills.
8
8
 
9
9
  [![官网 sp.aiolaola.com](https://img.shields.io/badge/🌐_官网-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com)
10
10
  [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
@@ -16,33 +16,34 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
16
16
  >
17
17
  > 🌍 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)
18
18
 
19
- > 🆕 **v1.7.10 更新亮点**([完整 Release Notes →](RELEASE-NOTES.zh.md))
20
- > - 🐛 **Aider 用户请重装** —— 两个错叠一起等于完全不可用:真实 Aider 项目从来没被自动检测到过(它不创建 `.aider/` 目录),且 `CONVENTIONS.md` **不会**被自动加载(官方要求 `--read`)。现在检测认真实标记,装完打印激活命令
21
- > - 🐛 **Kiro 用户请重装** —— `.kiro/steering/` 下的文件**每轮对话全量进上下文**,而我们把 20 个 skill 正文全塞了进去:实测 **335 KB/轮**。改为索引式后 **4.4 KB**(76 倍),重装会自动清旧布局
22
- > - 🐛 **Qoder 工具映射表有错** —— `Explore`/`Plan` 的 agent 名是编的(官方就是同名),且表没标适用范围(只覆盖 Qoder CLI,IDE 不同)([#119](https://github.com/jnMetaCode/superpowers-zh/issues/119))
23
- > - 🛡️ **堵上「拿代码测代码」的测试盲区** —— Aider 那个 bug 能在 90 项全绿下活着,是因为测试 `mkdir .aider` 再断言认出 Aider。已补真实标记 + Kiro 两条硬回归守卫(90 → 101 pass)
24
- > - 🐛 **Hermes 用户请重装** —— 之前我们只装项目级 `.hermes/skills/`,而 Hermes 根本不读那个目录,等于**装了完全不生效**。现在改用 `npx superpowers-zh --global --tool hermes` 装到 `~/.hermes/skills/`([#45](https://github.com/jnMetaCode/superpowers-zh/issues/45))
25
- > - 🔍 **定位核查** —— 逐层比对上游,修掉 5 处「不是增量」的偏离;新增 audit 检查强制 fork 增量必须显式声明
26
- > - 🆕 **新增 Crush**(工具数 22 → 23)—— 若你已为 CC / Cursor / Codex 装过,Crush 其实已经能读到,别重复装
27
- > - 🎯 **上游 v6.2.0 对齐完成** —— audit 的结构漂移告警清零;C 块盘点时发现其中 3 项不是风格改动而是实质新规则
28
- > - 🐛 **两个 worktree / Gemini 的真问题** —— 修掉 worktree 清理静默空转;更正「Gemini 不支持子智能体」的错误说法(原说法会让 3 个 skill 在 Gemini CLI 上瘸腿)
29
- > - 🔄 **测试参考重构** —— `testing-anti-patterns` → `writing-good-tests`:从 5 个反模式清单改为两条原则 + 变异检查
30
- > - 🔄 **SDD 同步上游 v6.2.0** —— plan 作用域工作区(一份过期账本再也不会让控制者跳过整段任务)+ 五轮上限的唤回式修复循环与熔断裁定
31
- > - 🪟 **Windows bootstrap 修复** —— SessionStart hook 改经 Git Bash 分发(同步上游),hook 不加载 skill 就是死重
32
- > - 🧩 新增 **Cline** 与 **Kilo Code** 两款 VS Code 扩展(工具数 20 → 22)—— 按 rules 常驻开销做了专门设计,索引仅 4.5 KB
33
- > - 🔧 检测落空时会扫 PATH 给出**可直接复制的 `--tool` 命令**,不再只报「未检测到」
34
- > - 📦 README 补上 **Plugin Marketplace 安装方式**(`claude plugin marketplace add`,升级只需一条命令)
35
-
36
19
  ### 📊 项目规模
37
20
 
38
- | 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
21
+ | 📦 翻译 Skills | 🇨🇳 中国原创 Skills | 🤖 支持工具 |
39
22
  |:---:|:---:|:---:|
40
- | **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(华为云码道)/ Cline / Kilo Code / Crush** |
23
+ | **14** | **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** |
41
24
 
42
25
  ---
43
26
 
44
27
  ## ❤️ 赞助商 &nbsp;<sub>🙏 想出现在这里?联系 **jnMetaCode@qq.com** 赞助</sub>
45
28
 
29
+ <p align="center">
30
+ <a href="https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link">
31
+ <img src="assets/sponsors/infistar.jpg" alt="Infistar.cc 无限星河 —— 全模型 API 服务,一个 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek,价格低至官方渠道 1 折" width="100%">
32
+ </a>
33
+ </p>
34
+
35
+ **superpowers-zh × [Infistar.cc 无限星河](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)|全模型 API · 为 AI 编程注入稳定动力**
36
+
37
+ 感谢 Infistar.cc 无限星河 赞助并为 superpowers-zh 用户提供模型服务支持!
38
+
39
+ - ⚡ **稳定承载复杂开发任务**:提供高可用模型通道与多节点冗余,价格低至官方渠道 **1 折**,稳定支持需求分析、方案规划、TDD、调试及代码审查等长任务。
40
+ - 🧠 **一个 API Key 接入主流模型**:全面支持 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型,适配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 编程工具。
41
+ - 🛠️ **赋能完整开发工作流**:结合 superpowers-zh 的系统化 Skills,让 AI 更好地完成头脑风暴、计划执行、问题排查和质量检查。
42
+
43
+ 🎁 **superpowers-zh 用户专属福利:通过[此链接](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)注册并完成首次调用,即可领取 5 美元等值测试额度!**
44
+
45
+ <hr>
46
+
46
47
  <table>
47
48
  <tr>
48
49
  <td width="25%">
@@ -57,7 +58,6 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
57
58
  </td>
58
59
  </tr>
59
60
  </table>
60
-
61
61
  <table>
62
62
  <tr>
63
63
  <td width="25%">
@@ -69,6 +69,20 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
69
69
 
70
70
  感谢 [Cubence](https://cubence.com/signup?code=SCW29JP9) 对本项目的支持。Cubence 是一家致力为客户提供稳定、高效的 API 中转服务商。从 25 年 9 月运营至今,提供了 Claude Code、Codex、Gemini 等多种模型支持。🎁 **Cubence 为本开源项目的用户提供了特别的专属优惠码 `AGENCY`,通过[此链接](https://cubence.com/signup?code=SCW29JP9)注册的用户,首次购买即可享受 9 折优惠!**
71
71
 
72
+ </td>
73
+ </tr>
74
+ </table>
75
+ <table>
76
+ <tr>
77
+ <td width="25%">
78
+ <a href="https://go.apimart.ai/gh-superpowers-zh">
79
+ <img src="assets/sponsors/apimart.jpg" alt="APIMart —— 专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张" width="100%">
80
+ </a>
81
+ </td>
82
+ <td width="75%" valign="middle">
83
+
84
+ 感谢 [APIMart](https://go.apimart.ai/gh-superpowers-zh) 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,**GPT-Image-2 低至 $0.006/张**,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,🎁 **通过[此链接](https://go.apimart.ai/gh-superpowers-zh)注册即可开用!**
85
+
72
86
  </td>
73
87
  </tr>
74
88
  </table>
@@ -115,7 +129,7 @@ AI:在开始实现之前,我需要了解几个关键问题:
115
129
  | ⭐ Star 数 | 250k+ | — |
116
130
  | 📦 Skills 总数 | 14 | **20**(14 翻译 + 4 国产原创 + 2 上游历史保留) |
117
131
  | 🌐 语言 | 英文 | 中文(技术术语保留英文) |
118
- | 🤖 **支持工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **23 款**:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code(通义灵码)/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy(腾讯) / CodeArts(华为云码道) / Cline / Kilo Code / Crush |
132
+ | 🤖 **支持工具** | **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 |
119
133
  | ⚡ **安装方式** | 按工具分别装(每款一条不同的 plugin marketplace 命令) | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**;识别不出可 `--tool <name>` 显式指定 |
120
134
  | 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + **CNB(腾讯云原生构建)** |
121
135
  | 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + `.cnb.yml` |
@@ -130,9 +144,9 @@ AI:在开始实现之前,我需要了解几个关键问题:
130
144
  | 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
131
145
  | 📜 License | MIT | MIT |
132
146
 
133
- **一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+** 23 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
147
+ **一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+** 26 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
134
148
 
135
- ### 🤖 支持 23 款主流 AI 编程工具
149
+ ### 🤖 支持 26 款主流 AI 编程工具
136
150
 
137
151
  | 工具 | 类型 | 一键安装 | 手动安装 |
138
152
  |------|------|:---:|:---:|
@@ -140,25 +154,28 @@ AI:在开始实现之前,我需要了解几个关键问题:
140
154
  | [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
141
155
  | [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --global --tool hermes` | `~/.hermes/skills/` |
142
156
  | [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
143
- | [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
157
+ | [Windsurf](https://windsurf.com) | IDE | `npx superpowers-zh` | `.windsurf/skills/`(全局 `~/.codeium/windsurf/skills/`) |
144
158
  | [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/skills/` |
145
159
  | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | CLI | `npx superpowers-zh` | `.gemini/skills/` |
146
- | [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.codex/skills/` |
160
+ | [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.agents/skills/` |
147
161
  | [Aider](https://aider.chat) | CLI | `npx superpowers-zh` | `.aider/skills/` |
148
162
  | [Trae](https://trae.ai) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |
149
- | [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` |
163
+ | [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` + `.github/instructions/` |
150
164
  | [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
151
165
  | [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
152
- | [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
153
- | [Qwen Code](https://tongyi.aliyun.com/lingma) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |
154
- | [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.agents/skills/` |
166
+ | [OpenClaw](https://github.com/openclaw/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
167
+ | [Qwen Code](https://github.com/QwenLM/qwen-code) | CLI | `npx superpowers-zh` | `.qwen/skills/` + `QWEN.md` |
168
+ | [Antigravity](https://antigravity.google) | IDE | `npx superpowers-zh` | `.agents/skills/` |
155
169
  | [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |
156
170
  | [Qoder](https://qoder.com) (阿里 AI IDE) | IDE | `npx superpowers-zh` | `.qoder/skills/` + `.qoder/rules/` |
157
171
  | [CodeBuddy](https://copilot.tencent.com) (腾讯 AI IDE) | IDE | `npx superpowers-zh` | `.codebuddy/skills/` + `CODEBUDDY.md` |
158
- | [华为云码道 CodeArts](https://www.huaweicloud.com/product/codeartsdoer.html) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` |
172
+ | [华为云码道 CodeArts](https://codearts.huaweicloud.com/) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` |
159
173
  | [Cline](https://cline.bot) | IDE 插件 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` |
160
174
  | [Kilo Code](https://kilo.ai) | IDE 插件 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` |
161
175
  | [Crush](https://github.com/charmbracelet/crush) | CLI | `npx superpowers-zh` | `.crush/skills/` |
176
+ | [ZCode](https://zcode.z.ai/) (智谱 ADE) | IDE | `npx superpowers-zh --global --tool zcode` | `~/.zcode/skills/`(仅全局,项目级路径官方未公开) |
177
+ | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) | CLI | `npx superpowers-zh` | `.dsh/skills/` + `AGENTS.md` |
178
+ | [Reasonix](https://reasonix.io/) | CLI | `npx superpowers-zh` | `.reasonix/skills/` + `REASONIX.md`(全局 Windows 为 `%APPDATA%\reasonix\skills`) |
162
179
 
163
180
  > 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具,将 20 个 skills 安装到正确位置。
164
181
 
@@ -181,10 +198,12 @@ AI:在开始实现之前,我需要了解几个关键问题:
181
198
  | **编写 Skills** (writing-skills) | 创建新 skill 的方法论 |
182
199
  | **使用 Superpowers** (using-superpowers) | 元技能:如何调用和优先使用 skills |
183
200
 
184
- ### 🇨🇳 中国特色 Skills(6 个)
201
+ ### 🇨🇳 中国原创 Skills(4 个)· 上游历史保留(2 个)
185
202
 
186
203
  > ⚠️ **下表前 4 个 chinese-\* 为「手动调用」skill**——不会自动触发,需在对话中显式输入 `/chinese-xxx` 才会加载。
187
204
  > 设计为参考资料而非工作流,避免污染上游 skill 的自动调度(如 `requesting-code-review`、`brainstorming` 等)。
205
+ >
206
+ > ⚠️ **表格最后两个(mcp-builder / workflow-runner)不是中国原创** —— 它们来自上游,上游后来移除了,本 fork 保留下来继续维护。全仓 20 个 skill = 14 翻译 + 4 中国原创 + 2 上游历史保留。
188
207
 
189
208
  | Skill | 用途 | 调用方式 | 上游有吗? |
190
209
  |-------|------|---------|:---:|
@@ -192,8 +211,8 @@ AI:在开始实现之前,我需要了解几个关键问题:
192
211
  | **中文 Git 工作流** (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab/CNB | `/chinese-git-workflow`(手动) | 无 |
193
212
  | **中文技术文档** (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | `/chinese-documentation`(手动) | 无 |
194
213
  | **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | `/chinese-commit-conventions`(手动) | 无 |
195
- | **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具,扩展 AI 能力边界 | 自动 | |
196
- | **工作流执行器** (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 自动 | |
214
+ | **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具,扩展 AI 能力边界 | 自动 | 曾有,上游已移除 |
215
+ | **工作流执行器** (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 自动 | 曾有,上游已移除 |
197
216
 
198
217
  ---
199
218
 
@@ -219,7 +238,7 @@ npx superpowers-zh --global --tool claude # 或指定工具
219
238
 
220
239
  全局安装把 skills 装到工具的**用户级目录**(如 `~/.claude/skills`),一次安装所有项目自动可用,更新时也只需重装一次。**项目级优先、全局兜底**,二者可共存。
221
240
 
222
- 支持通用全局安装的工具(均为 docs 已证实的用户级加载路径):**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent**。其中 **Codex CLI** 全局装到 `~/.agents/skills`(Codex 启动扫描目录)。其余工具(Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Claw / Cline / Kilo Code)规则是项目级或存于应用内设置,`--global` 会提示改用项目级;**Gemini CLI / Antigravity** 有各自专属的全局方式(Gemini 走扩展目录),见对应 `docs/README.*.md`。
241
+ 支持通用全局安装的工具(均为 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`。
223
242
 
224
243
  | | 项目级(默认) | 全局(`--global`) |
225
244
  |---|---|---|
@@ -311,11 +330,11 @@ cp -r superpowers-zh/skills /your/project/.qoder/skills # Qoder(阿里 AI
311
330
  | Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |
312
331
  | OpenCode | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 |
313
332
  | Hermes Agent | `.hermes/skills/*/SKILL.md` | 项目级 skills 目录 |
314
- | Qwen Code | `.qwen/skills/*/SKILL.md` | 项目级 skills 目录 |
333
+ | Qwen Code | `.qwen/skills/*/SKILL.md` + `QWEN.md` | skills 自动发现;QWEN.md 是官方分层记忆的默认上下文文件 |
315
334
  | Claw Code | `.claw/skills/*/SKILL.md` | Rust 版 CLI agent,兼容 Claude Code 的 SKILL.md 格式 |
316
335
  | Qoder | `.qoder/skills/*/SKILL.md` + `.qoder/rules/superpowers-zh.md` | 阿里 AI IDE,自动生成 `trigger: always_on` 的 bootstrap rule |
317
336
 
318
- > **详细安装指南**:[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) · [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)
337
+ > **详细安装指南**:[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)
319
338
 
320
339
  ### 卸载 / 误装清理(v1.2.1+)
321
340
 
@@ -427,10 +446,39 @@ MIT License — 自由使用,商业或个人均可。
427
446
 
428
447
  ---
429
448
 
449
+ ## 📌 最近更新
450
+
451
+ > 🆕 **v1.7.12 更新亮点** —— **通过 Claude Code 插件市场安装的用户请更新**(此前技能之间互相调用会失败):
452
+ >
453
+ > - 🐛 **插件模式下跨技能调用全部失败**([#124](https://github.com/jnMetaCode/superpowers-zh/issues/124))—— 正文照抄了上游的 `superpowers:` 前缀,而本插件叫 `superpowers-zh`,于是 `Skill("superpowers:systematic-debugging")` 返回 Unknown skill。32 处已改为**裸技能名**(两种分发模式都能解析)
454
+ > - 🐛 **Crush 在 Windows 上装错目录** —— 官方是 `%LOCALAPPDATA%\crush\skills`,我们两个平台都装 `~/.config`。文档早写对了,代码没跟上
455
+ > - 🐛 **render-graphs.js** —— 取上游的安全加固与 Windows 修复,但**不跟它改 ESM**(那会在 Node 20 的普通项目里直接加载失败)
456
+ > - 🆕 **新增 DeepSeek Harness 支持**([#122](https://github.com/jnMetaCode/superpowers-zh/issues/122))—— 项目级 `.dsh/skills/` + 全局 `~/.dsh/skills/`,引导写 `AGENTS.md`;四条路径全部有官方出处
457
+ > - 🐛 **在管理员 PowerShell 里跑会把 skills 装进 `C:\Windows\System32`**([#125](https://github.com/jnMetaCode/superpowers-zh/issues/125))—— 管理员终端的默认工作目录就是那里。补系统目录护栏,且不提供 `--force` 绕过
458
+ > - 🆕 **新增 Reasonix 支持**([#42](https://github.com/jnMetaCode/superpowers-zh/issues/42))—— 项目级 `.reasonix/skills/` + `REASONIX.md`;**Windows 全局是 `%APPDATA%\reasonix\skills`**,与 Unix 不同构
459
+ > - 🆕 **新增 ZCode(智谱)支持**(工具数 23 → 26)—— 只做全局安装:官方文档只公开了 `~/.zcode/skills/`,项目级是应用内 UI 导入、不暴露磁盘路径,所以项目级会被明确拒绝而不是猜路径装进去
460
+ > - 🛡️ **6 条新门禁**(前缀回归、Windows 路径、卸载不误删用户文件、全局-only 工具项目级必拒、上游漂移计量…),`verify-release` 115 → 144
461
+ >
462
+ > 📋 官网侧改动(版本提示条、22 份工具文档入口、结构化数据、分享大图、可访问性、sitemap…)见 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
463
+
464
+ ---
465
+
430
466
  <div align="center">
431
467
 
432
- **🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具真正会干活**
468
+ **🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具真正会干活**
433
469
 
434
470
  [Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
435
471
 
436
472
  </div>
473
+
474
+ ---
475
+
476
+ ## 📈 Star 趋势
477
+
478
+ <a href="https://star-history.com/#jnMetaCode/superpowers-zh&Date">
479
+ <picture>
480
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date&theme=dark">
481
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date">
482
+ <img alt="superpowers-zh 的 GitHub Star 增长曲线" src="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date">
483
+ </picture>
484
+ </a>
package/README.zh-Hant.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  🌐 [简体中文](README.md) | **繁體中文** | [English (upstream)](https://github.com/obra/superpowers)
4
4
 
5
- > 🦸 **superpowers(250k+ ⭐)完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **23 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查,從 TDD 到除錯,每個 skill 都是經過實戰驗證的工作方法論。
5
+ > 🦸 **superpowers(250k+ ⭐)完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查,從 TDD 到除錯,每個 skill 都是經過實戰驗證的工作方法論。
6
6
 
7
- Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 23 AI coding tools, including full translations and China-specific development skills.
7
+ Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 26 AI coding tools, including full translations and China-specific development skills.
8
8
 
9
9
  [![官網 sp.aiolaola.com](https://img.shields.io/badge/🌐_官網-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com)
10
10
  [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
@@ -16,33 +16,34 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
16
16
 
17
17
  > 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers):180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費
18
18
 
19
- > 🆕 **v1.7.10 更新亮點**([完整 Release Notes →](RELEASE-NOTES.zh.md))
20
- > - 🐛 **Aider 使用者請重裝** —— 兩個錯疊一起等於完全不可用:真實 Aider 專案從來沒被自動偵測到過(它不建立 `.aider/` 目錄),且 `CONVENTIONS.md` **不會**被自動載入(官方要求 `--read`)。現在偵測認真實標記,裝完列印啟用命令
21
- > - 🐛 **Kiro 使用者請重裝** —— `.kiro/steering/` 下的檔案**每輪對話全量進上下文**,而我們把 20 個 skill 正文全塞了進去:實測 **335 KB/輪**。改為索引式後 **4.4 KB**(76 倍),重裝會自動清舊佈局
22
- > - 🐛 **Qoder 工具對映表有錯** —— `Explore`/`Plan` 的 agent 名是編的(官方就是同名),且表沒標適用範圍(只涵蓋 Qoder CLI,IDE 不同)([#119](https://github.com/jnMetaCode/superpowers-zh/issues/119))
23
- > - 🛡️ **堵上「拿程式碼測程式碼」的測試盲區** —— Aider 那個 bug 能在 90 項全綠下活著,是因為測試 `mkdir .aider` 再斷言認出 Aider。已補真實標記 + Kiro 兩條硬回歸守衛(90 → 101 pass)
24
- > - 🐛 **Hermes 使用者請重裝** —— 之前我們只裝專案級 `.hermes/skills/`,而 Hermes 根本不讀那個目錄,等於**裝了完全不生效**。現在改用 `npx superpowers-zh --global --tool hermes` 裝到 `~/.hermes/skills/`([#45](https://github.com/jnMetaCode/superpowers-zh/issues/45))
25
- > - 🔍 **定位核查** —— 逐層比對上游,修掉 5 處「不是增量」的偏離;新增 audit 檢查強制 fork 增量必須顯式聲明
26
- > - 🆕 **新增 Crush**(工具數 22 → 23)—— 若你已為 CC / Cursor / Codex 裝過,Crush 其實已經能讀到,別重複裝
27
- > - 🎯 **上游 v6.2.0 對齊完成** —— audit 的結構漂移告警清零;C 塊盤點時發現其中 3 項不是風格改動而是實質新規則
28
- > - 🐛 **兩個 worktree / Gemini 的真問題** —— 修掉 worktree 清理靜默空轉;更正「Gemini 不支援子智能體」的錯誤說法(原說法會讓 3 個 skill 在 Gemini CLI 上瘸腿)
29
- > - 🔄 **測試參考重構** —— `testing-anti-patterns` → `writing-good-tests`:從 5 個反模式清單改為兩條原則 + 變異檢查
30
- > - 🔄 **SDD 同步上游 v6.2.0** —— plan 作用域工作區(一份過期帳本再也不會讓控制者跳過整段任務)+ 五輪上限的喚回式修復循環與熔斷裁定
31
- > - 🪟 **Windows bootstrap 修復** —— SessionStart hook 改經 Git Bash 分發(同步上游),hook 不載入 skill 就是死重
32
- > - 🧩 新增 **Cline** 與 **Kilo Code** 兩款 VS Code 外掛(工具數 20 → 22)—— 針對 rules 常駐開銷做了專門設計,索引僅 4.5 KB
33
- > - 🔧 偵測落空時會掃 PATH 給出**可直接複製的 `--tool` 命令**,不再只報「未偵測到」
34
- > - 📦 README 補上 **Plugin Marketplace 安裝方式**(`claude plugin marketplace add`,升級只需一條命令)
35
-
36
19
  ### 📊 專案規模
37
20
 
38
- | 📦 翻譯 Skills | 🇨🇳 中國特色 Skills | 🤖 支援工具 |
21
+ | 📦 翻譯 Skills | 🇨🇳 中國原創 Skills | 🤖 支援工具 |
39
22
  |:---:|:---:|:---:|
40
- | **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(華為雲碼道)/ Cline / Kilo Code / Crush** |
23
+ | **14** | **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** |
41
24
 
42
25
  ---
43
26
 
44
27
  ## ❤️ 贊助商 &nbsp;<sub>🙏 想出現在這裡?聯絡 **jnMetaCode@qq.com** 贊助</sub>
45
28
 
29
+ <p align="center">
30
+ <a href="https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link">
31
+ <img src="assets/sponsors/infistar.jpg" alt="Infistar.cc 無限星河 —— 全模型 API 服務,一個 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek,價格低至官方渠道 1 折" width="100%">
32
+ </a>
33
+ </p>
34
+
35
+ **superpowers-zh × [Infistar.cc 無限星河](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)|全模型 API · 為 AI 編程注入穩定動力**
36
+
37
+ 感謝 Infistar.cc 無限星河 贊助並為 superpowers-zh 使用者提供模型服務支援!
38
+
39
+ - ⚡ **穩定承載複雜開發任務**:提供高可用模型通道與多節點冗餘,價格低至官方渠道 **1 折**,穩定支援需求分析、方案規劃、TDD、除錯及程式碼審查等長任務。
40
+ - 🧠 **一個 API Key 接入主流模型**:全面支援 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型,適配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 編程工具。
41
+ - 🛠️ **賦能完整開發工作流**:結合 superpowers-zh 的系統化 Skills,讓 AI 更好地完成頭腦風暴、計畫執行、問題排查和品質檢查。
42
+
43
+ 🎁 **superpowers-zh 使用者專屬福利:透過[此連結](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)註冊並完成首次呼叫,即可領取 5 美元等值測試額度!**
44
+
45
+ <hr>
46
+
46
47
  <table>
47
48
  <tr>
48
49
  <td width="25%">
@@ -57,7 +58,6 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
57
58
  </td>
58
59
  </tr>
59
60
  </table>
60
-
61
61
  <table>
62
62
  <tr>
63
63
  <td width="25%">
@@ -69,6 +69,20 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
69
69
 
70
70
  感謝 [Cubence](https://cubence.com/signup?code=SCW29JP9) 對本專案的支持。Cubence 是一家致力為客戶提供穩定、高效的 API 中轉服務商。從 25 年 9 月營運至今,提供了 Claude Code、Codex、Gemini 等多種模型支援。🎁 **Cubence 為本開源專案的使用者提供了特別的專屬優惠碼 `AGENCY`,透過[此連結](https://cubence.com/signup?code=SCW29JP9)註冊的使用者,首次購買即可享受 9 折優惠!**
71
71
 
72
+ </td>
73
+ </tr>
74
+ </table>
75
+ <table>
76
+ <tr>
77
+ <td width="25%">
78
+ <a href="https://go.apimart.ai/gh-superpowers-zh">
79
+ <img src="assets/sponsors/apimart.jpg" alt="APIMart —— 專注 AI 圖片/影片生成的低價 API 平台,GPT-Image-2 低至 $0.006/張,1 美元可出圖 160+ 張" width="100%">
80
+ </a>
81
+ </td>
82
+ <td width="75%" valign="middle">
83
+
84
+ 感謝 [APIMart](https://go.apimart.ai/gh-superpowers-zh) 贊助了本專案!APIMart 是專注 AI 圖片/影片生成的低價 API 平台,**GPT-Image-2 低至 $0.006/張**,1 美元可出圖 160+ 張。圖片、影片一套非同步 API 通吃,提交任務拿 ID、回呼取結果,跑批萬張不逾時、換模型不改程式碼。按量付費、無月費,🎁 **透過[此連結](https://go.apimart.ai/gh-superpowers-zh)註冊即可開用!**
85
+
72
86
  </td>
73
87
  </tr>
74
88
  </table>
@@ -115,7 +129,7 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
115
129
  | ⭐ Star 數 | 250k+ | — |
116
130
  | 📦 Skills 總數 | 14 | **20**(14 翻譯 + 4 國產原創 + 2 上游歷史保留) |
117
131
  | 🌐 語言 | 英文 | 中文(技術術語保留英文) |
118
- | 🤖 **支援工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **23 款**:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code(通義靈碼)/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy(騰訊) / CodeArts(華為雲碼道) / Cline / Kilo Code / Crush |
132
+ | 🤖 **支援工具** | **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 |
119
133
  | ⚡ **安裝方式** | 按工具分別裝(每款一條不同的 plugin marketplace 命令) | **`npx superpowers-zh` 一條命令自動識別專案裡的工具並安裝**;識別不出可 `--tool <name>` 顯式指定 |
120
134
  | 🇨🇳 Git 平台 | GitHub 為主 | GitHub + Gitee + Coding + 極狐 GitLab + **CNB(騰訊雲原生建置)** |
121
135
  | 🇨🇳 CI/CD 範例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 極狐 CI + `.cnb.yml` |
@@ -130,9 +144,9 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
130
144
  | 💬 社群 | Discord | 微信公眾號「AI不止語」+ 微信群 + QQ 群 |
131
145
  | 📜 License | MIT | MIT |
132
146
 
133
- **一句話總結:** 英文上游 = 方法論核心;中文增強版 = 方法論核心 **+** 23 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。
147
+ **一句話總結:** 英文上游 = 方法論核心;中文增強版 = 方法論核心 **+** 26 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。
134
148
 
135
- ### 🤖 支援 23 款主流 AI 編程工具
149
+ ### 🤖 支援 26 款主流 AI 編程工具
136
150
 
137
151
  | 工具 | 類型 | 一鍵安裝 | 手動安裝 |
138
152
  |------|------|:---:|:---:|
@@ -140,25 +154,28 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
140
154
  | [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
141
155
  | [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --global --tool hermes` | `~/.hermes/skills/` |
142
156
  | [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
143
- | [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
157
+ | [Windsurf](https://windsurf.com) | IDE | `npx superpowers-zh` | `.windsurf/skills/`(全局 `~/.codeium/windsurf/skills/`) |
144
158
  | [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/skills/` |
145
159
  | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | CLI | `npx superpowers-zh` | `.gemini/skills/` |
146
- | [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.codex/skills/` |
160
+ | [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.agents/skills/` |
147
161
  | [Aider](https://aider.chat) | CLI | `npx superpowers-zh` | `.aider/skills/` |
148
162
  | [Trae](https://trae.ai) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |
149
- | [VS Code](https://code.visualstudio.com) (Copilot) | IDE 外掛 | `npx superpowers-zh` | `.github/superpowers/` |
163
+ | [VS Code](https://code.visualstudio.com) (Copilot) | IDE 外掛 | `npx superpowers-zh` | `.github/superpowers/` + `.github/instructions/` |
150
164
  | [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
151
165
  | [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
152
- | [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
153
- | [Qwen Code](https://tongyi.aliyun.com/lingma) (通義靈碼) | IDE 外掛 | `npx superpowers-zh` | `.qwen/skills/` |
154
- | [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.agents/skills/` |
166
+ | [OpenClaw](https://github.com/openclaw/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
167
+ | [Qwen Code](https://github.com/QwenLM/qwen-code) | CLI | `npx superpowers-zh` | `.qwen/skills/` + `QWEN.md` |
168
+ | [Antigravity](https://antigravity.google) | IDE | `npx superpowers-zh` | `.agents/skills/` |
155
169
  | [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |
156
170
  | [Qoder](https://qoder.com) (阿里 AI IDE) | IDE | `npx superpowers-zh` | `.qoder/skills/` + `.qoder/rules/` |
157
171
  | [CodeBuddy](https://copilot.tencent.com) (騰訊 AI IDE) | IDE | `npx superpowers-zh` | `.codebuddy/skills/` + `CODEBUDDY.md` |
158
- | [華為雲碼道 CodeArts](https://www.huaweicloud.com/product/codeartsdoer.html) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` |
172
+ | [華為雲碼道 CodeArts](https://codearts.huaweicloud.com/) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` |
159
173
  | [Cline](https://cline.bot) | IDE 外掛 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` |
160
174
  | [Kilo Code](https://kilo.ai) | IDE 外掛 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` |
161
175
  | [Crush](https://github.com/charmbracelet/crush) | CLI | `npx superpowers-zh` | `.crush/skills/` |
176
+ | [ZCode](https://zcode.z.ai/) (智譜 ADE) | IDE | `npx superpowers-zh --global --tool zcode` | `~/.zcode/skills/`(僅全域,專案級路徑官方未公開) |
177
+ | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) | CLI | `npx superpowers-zh` | `.dsh/skills/` + `AGENTS.md` |
178
+ | [Reasonix](https://reasonix.io/) | CLI | `npx superpowers-zh` | `.reasonix/skills/` + `REASONIX.md`(全域 Windows 為 `%APPDATA%\reasonix\skills`) |
162
179
 
163
180
  > 執行 `npx superpowers-zh` 會自動偵測你專案中使用的工具,將 20 個 skills 安裝到正確位置。
164
181
 
@@ -181,10 +198,12 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
181
198
  | **編寫 Skills** (writing-skills) | 建立新 skill 的方法論 |
182
199
  | **使用 Superpowers** (using-superpowers) | 元技能:如何呼叫和優先使用 skills |
183
200
 
184
- ### 🇨🇳 中國特色 Skills(6 個)
201
+ ### 🇨🇳 中國原創 Skills(4 個)· 上游歷史保留(2 個)
185
202
 
186
203
  > ⚠️ **下表前 4 個 chinese-\* 為「手動呼叫」skill**——不會自動觸發,需在對話中顯式輸入 `/chinese-xxx` 才會載入。
187
204
  > 設計為參考資料而非工作流,避免污染上游 skill 的自動排程(如 `requesting-code-review`、`brainstorming` 等)。
205
+ >
206
+ > ⚠️ **表格最後兩個(mcp-builder / workflow-runner)不是中國原創** —— 它們來自上游,上游後來移除了,本 fork 保留下來繼續維護。全倉 20 個 skill = 14 翻譯 + 4 中國原創 + 2 上游歷史保留。
188
207
 
189
208
  | Skill | 用途 | 呼叫方式 | 上游有嗎? |
190
209
  |-------|------|---------|:---:|
@@ -192,8 +211,8 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
192
211
  | **中文 Git 工作流** (chinese-git-workflow) | 適配 Gitee/Coding/極狐 GitLab/CNB | `/chinese-git-workflow`(手動) | 無 |
193
212
  | **中文技術文件** (chinese-documentation) | 中文排版規範、中英混排、告別機翻味 | `/chinese-documentation`(手動) | 無 |
194
213
  | **中文提交規範** (chinese-commit-conventions) | 適配國內團隊的 commit message 規範 | `/chinese-commit-conventions`(手動) | 無 |
195
- | **MCP 伺服器建置** (mcp-builder) | 建置生產級 MCP 工具,擴展 AI 能力邊界 | 自動 | |
196
- | **工作流執行器** (workflow-runner) | 在 AI 工具內執行多角色 YAML 工作流 | 自動 | |
214
+ | **MCP 伺服器建置** (mcp-builder) | 建置生產級 MCP 工具,擴展 AI 能力邊界 | 自動 | 曾有,上游已移除 |
215
+ | **工作流執行器** (workflow-runner) | 在 AI 工具內執行多角色 YAML 工作流 | 自動 | 曾有,上游已移除 |
197
216
 
198
217
  ---
199
218
 
@@ -219,7 +238,7 @@ npx superpowers-zh --global --tool claude # 或指定工具
219
238
 
220
239
  全域安裝把 skills 裝到工具的**使用者級目錄**(如 `~/.claude/skills`),一次安裝所有專案自動可用,更新時也只需重裝一次。**專案級優先、全域兜底**,二者可共存。
221
240
 
222
- 支援通用全域安裝的工具(均為 docs 已證實的使用者級載入路徑):**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent**。其中 **Codex CLI** 全域裝到 `~/.agents/skills`(Codex 啟動掃描目錄)。其餘工具(Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Claw / Cline / Kilo Code)規則是專案級或存於應用內設定,`--global` 會提示改用專案級;**Gemini CLI / Antigravity** 有各自專屬的全域方式(Gemini 走擴充目錄),見對應 `docs/README.*.md`。
241
+ 支援通用全域安裝的工具(均為 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`。
223
242
 
224
243
  | | 專案級(預設) | 全域(`--global`) |
225
244
  |---|---|---|
@@ -315,7 +334,7 @@ cp -r superpowers-zh/skills /your/project/.qoder/skills # Qoder(阿里 AI
315
334
  | Claw Code | `.claw/skills/*/SKILL.md` | Rust 版 CLI agent,相容 Claude Code 的 SKILL.md 格式 |
316
335
  | Qoder | `.qoder/skills/*/SKILL.md` + `.qoder/rules/superpowers-zh.md` | 阿里 AI IDE,自動產生 `trigger: always_on` 的 bootstrap rule |
317
336
 
318
- > **詳細安裝指南**:[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) · [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)
337
+ > **詳細安裝指南**:[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)
319
338
 
320
339
  ### 解除安裝 / 誤裝清理(v1.2.1+)
321
340
 
@@ -427,10 +446,39 @@ MIT License — 自由使用,商業或個人均可。
427
446
 
428
447
  ---
429
448
 
449
+ ## 📌 最近更新
450
+
451
+ > 🆕 **v1.7.12 更新亮點** —— **透過 Claude Code 外掛市集安裝的使用者請更新**(此前技能之間互相呼叫會失敗):
452
+ >
453
+ > - 🐛 **外掛模式下跨技能呼叫全部失敗**([#124](https://github.com/jnMetaCode/superpowers-zh/issues/124))—— 正文照抄了上游的 `superpowers:` 前綴,而本外掛叫 `superpowers-zh`,於是 `Skill("superpowers:systematic-debugging")` 回傳 Unknown skill。32 處已改為**裸技能名**(兩種分發模式都能解析)
454
+ > - 🐛 **Crush 在 Windows 上裝錯目錄** —— 官方是 `%LOCALAPPDATA%\crush\skills`,我們兩個平台都裝 `~/.config`。文件早寫對了,程式碼沒跟上
455
+ > - 🐛 **render-graphs.js** —— 取上游的安全加固與 Windows 修復,但**不跟它改 ESM**(那會在 Node 20 的普通專案裡直接載入失敗)
456
+ > - 🆕 **新增 DeepSeek Harness 支援**([#122](https://github.com/jnMetaCode/superpowers-zh/issues/122))—— 專案級 `.dsh/skills/` + 全域 `~/.dsh/skills/`,引導寫 `AGENTS.md`;四條路徑全部有官方出處
457
+ > - 🐛 **在管理員 PowerShell 裡跑會把 skills 裝進 `C:\Windows\System32`**([#125](https://github.com/jnMetaCode/superpowers-zh/issues/125))—— 管理員終端的預設工作目錄就是那裡。補系統目錄護欄,且不提供 `--force` 繞過
458
+ > - 🆕 **新增 Reasonix 支援**([#42](https://github.com/jnMetaCode/superpowers-zh/issues/42))—— 專案級 `.reasonix/skills/` + `REASONIX.md`;**Windows 全域是 `%APPDATA%\reasonix\skills`**,與 Unix 不同構
459
+ > - 🆕 **新增 ZCode(智譜)支援**(工具數 23 → 26)—— 只做全域安裝:官方文件只公開了 `~/.zcode/skills/`,專案級是應用內 UI 匯入、不暴露磁碟路徑,所以專案級會被明確拒絕而不是猜路徑裝進去
460
+ > - 🛡️ **6 條新門禁**(前綴回歸、Windows 路徑、解除安裝不誤刪使用者檔案、全域-only 工具專案級必拒、上游漂移計量…),`verify-release` 115 → 144
461
+ >
462
+ > 📋 官網側改動(版本提示條、22 份工具文件入口、結構化資料、分享大圖、無障礙、sitemap…)見 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
463
+
464
+ ---
465
+
430
466
  <div align="center">
431
467
 
432
- **🦸 AI 編程超能力:讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具真正會幹活**
468
+ **🦸 AI 編程超能力:讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具真正會幹活**
433
469
 
434
470
  [Star 本專案](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [貢獻程式碼](https://github.com/jnMetaCode/superpowers-zh/pulls)
435
471
 
436
472
  </div>
473
+
474
+ ---
475
+
476
+ ## 📈 Star 趨勢
477
+
478
+ <a href="https://star-history.com/#jnMetaCode/superpowers-zh&Date">
479
+ <picture>
480
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date&theme=dark">
481
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date">
482
+ <img alt="superpowers-zh 的 GitHub Star 增長曲線" src="https://api.star-history.com/svg?repos=jnMetaCode/superpowers-zh&type=Date">
483
+ </picture>
484
+ </a>