superpowers-zh 1.7.11 → 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.
- package/.claude-plugin/marketplace.json +3 -3
- package/.claude-plugin/plugin.json +2 -2
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +2 -2
- package/CLAUDE.md +1 -1
- package/README.md +53 -17
- package/README.zh-Hant.md +53 -17
- package/RELEASE-NOTES.zh.md +219 -0
- package/assets/og-image.jpg +0 -0
- package/assets/sponsors/apimart.jpg +0 -0
- package/assets/sponsors/logo-apimart-icon.png +0 -0
- package/bin/superpowers-zh.js +264 -15
- package/docs/README.deepseek-harness.md +56 -0
- package/docs/README.hermes.md +5 -3
- package/docs/README.reasonix.md +57 -0
- package/docs/README.zcode.md +56 -0
- package/gemini-extension.json +1 -1
- package/package.json +2 -2
- package/skills/brainstorming/SKILL.md +69 -18
- package/skills/brainstorming/visual-companion.md +9 -0
- package/skills/executing-plans/SKILL.md +3 -3
- package/skills/finishing-a-development-branch/SKILL.md +21 -0
- package/skills/requesting-code-review/code-reviewer.md +8 -0
- package/skills/subagent-driven-development/SKILL.md +33 -19
- package/skills/subagent-driven-development/implementer-prompt.md +4 -0
- package/skills/subagent-driven-development/re-review-prompt.md +4 -0
- package/skills/subagent-driven-development/task-reviewer-prompt.md +19 -0
- package/skills/systematic-debugging/SKILL.md +2 -2
- package/skills/test-driven-development/writing-good-tests.md +1 -1
- package/skills/using-superpowers/SKILL.md +7 -7
- package/skills/using-superpowers/references/codex-tools.md +53 -2
- package/skills/using-superpowers/references/copilot-tools.md +1 -1
- package/skills/using-superpowers/references/gemini-tools.md +2 -2
- package/skills/using-superpowers/references/hermes-tools.md +55 -42
- package/skills/using-superpowers/references/qoder-tools.md +1 -1
- package/skills/writing-plans/SKILL.md +10 -3
- package/skills/writing-skills/SKILL.md +4 -4
- package/skills/writing-skills/render-graphs.js +12 -4
- 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 等
|
|
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 等
|
|
12
|
-
"version": "1.7.
|
|
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 等
|
|
4
|
-
"version": "1.7.
|
|
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,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 等
|
|
5
|
-
"version": "1.7.
|
|
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 一条命令支持
|
|
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 等 **
|
|
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
|
|
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
|
[](https://sp.aiolaola.com)
|
|
10
10
|
[](https://github.com/jnMetaCode/superpowers-zh)
|
|
@@ -16,15 +16,6 @@ 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.11 更新亮点** —— **Codex / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 用户请重装**(此前装了等于没装):
|
|
20
|
-
>
|
|
21
|
-
> - 🐛 **Codex CLI** —— 项目级装到 `.codex/skills`,而官方扫描清单里**从来没有这个目录**。改为 `.agents/skills`,重装会自动清旧位置
|
|
22
|
-
> - 🐛 **VS Code (Copilot)** —— 装的 20 个文件 Copilot 一个都不读,且不写任何引导。现在生成 `.github/instructions/superpowers-zh.instructions.md`(`applyTo: "**"`)
|
|
23
|
-
> - 🐛 **Windsurf** —— `--global` 装到 `~/.windsurf/skills`,官方用户级路径是 `~/.codeium/windsurf/skills/`。全局装过的请重装
|
|
24
|
-
> - 🆕 **Qwen Code / Claw Code 补 bootstrap,CodeBuddy / CodeArts 补 `--global`**(全局支持 9 → 11 款)
|
|
25
|
-
>
|
|
26
|
-
> 📋 其余改动(DeerFlow 检测标记、4 条死链含 2 条编造的仓库地址、官网工具墙 20 → 23、5 条新门禁…)见 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
|
|
27
|
-
|
|
28
19
|
### 📊 项目规模
|
|
29
20
|
|
|
30
21
|
| 📦 翻译 Skills | 🇨🇳 中国原创 Skills | 🤖 支持工具 |
|
|
@@ -67,7 +58,6 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
67
58
|
</td>
|
|
68
59
|
</tr>
|
|
69
60
|
</table>
|
|
70
|
-
|
|
71
61
|
<table>
|
|
72
62
|
<tr>
|
|
73
63
|
<td width="25%">
|
|
@@ -79,6 +69,20 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
79
69
|
|
|
80
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 折优惠!**
|
|
81
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
|
+
|
|
82
86
|
</td>
|
|
83
87
|
</tr>
|
|
84
88
|
</table>
|
|
@@ -125,7 +129,7 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
125
129
|
| ⭐ Star 数 | 250k+ | — |
|
|
126
130
|
| 📦 Skills 总数 | 14 | **20**(14 翻译 + 4 国产原创 + 2 上游历史保留) |
|
|
127
131
|
| 🌐 语言 | 英文 | 中文(技术术语保留英文) |
|
|
128
|
-
| 🤖 **支持工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **
|
|
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 |
|
|
129
133
|
| ⚡ **安装方式** | 按工具分别装(每款一条不同的 plugin marketplace 命令) | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**;识别不出可 `--tool <name>` 显式指定 |
|
|
130
134
|
| 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + **CNB(腾讯云原生构建)** |
|
|
131
135
|
| 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + `.cnb.yml` |
|
|
@@ -140,9 +144,9 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
140
144
|
| 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
|
|
141
145
|
| 📜 License | MIT | MIT |
|
|
142
146
|
|
|
143
|
-
**一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+**
|
|
147
|
+
**一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+** 26 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
|
|
144
148
|
|
|
145
|
-
### 🤖 支持
|
|
149
|
+
### 🤖 支持 26 款主流 AI 编程工具
|
|
146
150
|
|
|
147
151
|
| 工具 | 类型 | 一键安装 | 手动安装 |
|
|
148
152
|
|------|------|:---:|:---:|
|
|
@@ -169,6 +173,9 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
169
173
|
| [Cline](https://cline.bot) | IDE 插件 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` |
|
|
170
174
|
| [Kilo Code](https://kilo.ai) | IDE 插件 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` |
|
|
171
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`) |
|
|
172
179
|
|
|
173
180
|
> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具,将 20 个 skills 安装到正确位置。
|
|
174
181
|
|
|
@@ -231,7 +238,7 @@ npx superpowers-zh --global --tool claude # 或指定工具
|
|
|
231
238
|
|
|
232
239
|
全局安装把 skills 装到工具的**用户级目录**(如 `~/.claude/skills`),一次安装所有项目自动可用,更新时也只需重装一次。**项目级优先、全局兜底**,二者可共存。
|
|
233
240
|
|
|
234
|
-
支持通用全局安装的工具(均为 docs 已证实的用户级加载路径):**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent · CodeBuddy · CodeArts**。其中 **Codex CLI** 全局装到 `~/.agents/skills`(Codex
|
|
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`。
|
|
235
242
|
|
|
236
243
|
| | 项目级(默认) | 全局(`--global`) |
|
|
237
244
|
|---|---|---|
|
|
@@ -439,10 +446,39 @@ MIT License — 自由使用,商业或个人均可。
|
|
|
439
446
|
|
|
440
447
|
---
|
|
441
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
|
+
|
|
442
466
|
<div align="center">
|
|
443
467
|
|
|
444
|
-
**🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等
|
|
468
|
+
**🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具真正会干活**
|
|
445
469
|
|
|
446
470
|
[Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
|
|
447
471
|
|
|
448
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 等 **
|
|
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
|
|
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
|
[](https://sp.aiolaola.com)
|
|
10
10
|
[](https://github.com/jnMetaCode/superpowers-zh)
|
|
@@ -16,15 +16,6 @@ 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.11 更新亮點** —— **Codex / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 使用者請重裝**(此前裝了等於沒裝):
|
|
20
|
-
>
|
|
21
|
-
> - 🐛 **Codex CLI** —— 專案級裝到 `.codex/skills`,而官方掃描清單裡**從來沒有這個目錄**。改為 `.agents/skills`,重裝會自動清舊位置
|
|
22
|
-
> - 🐛 **VS Code (Copilot)** —— 裝的 20 個檔案 Copilot 一個都不讀,且不寫任何引導。現在產生 `.github/instructions/superpowers-zh.instructions.md`(`applyTo: "**"`)
|
|
23
|
-
> - 🐛 **Windsurf** —— `--global` 裝到 `~/.windsurf/skills`,官方使用者級路徑是 `~/.codeium/windsurf/skills/`。全域裝過的請重裝
|
|
24
|
-
> - 🆕 **Qwen Code / Claw Code 補 bootstrap,CodeBuddy / CodeArts 補 `--global`**(全域支援 9 → 11 款)
|
|
25
|
-
>
|
|
26
|
-
> 📋 其餘改動(DeerFlow 偵測標記、4 條死連結含 2 條編造的儲存庫地址、官網工具牆 20 → 23、5 條新門禁…)見 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
|
|
27
|
-
|
|
28
19
|
### 📊 專案規模
|
|
29
20
|
|
|
30
21
|
| 📦 翻譯 Skills | 🇨🇳 中國原創 Skills | 🤖 支援工具 |
|
|
@@ -67,7 +58,6 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
67
58
|
</td>
|
|
68
59
|
</tr>
|
|
69
60
|
</table>
|
|
70
|
-
|
|
71
61
|
<table>
|
|
72
62
|
<tr>
|
|
73
63
|
<td width="25%">
|
|
@@ -79,6 +69,20 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
79
69
|
|
|
80
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 折優惠!**
|
|
81
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
|
+
|
|
82
86
|
</td>
|
|
83
87
|
</tr>
|
|
84
88
|
</table>
|
|
@@ -125,7 +129,7 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
|
|
|
125
129
|
| ⭐ Star 數 | 250k+ | — |
|
|
126
130
|
| 📦 Skills 總數 | 14 | **20**(14 翻譯 + 4 國產原創 + 2 上游歷史保留) |
|
|
127
131
|
| 🌐 語言 | 英文 | 中文(技術術語保留英文) |
|
|
128
|
-
| 🤖 **支援工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **
|
|
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 |
|
|
129
133
|
| ⚡ **安裝方式** | 按工具分別裝(每款一條不同的 plugin marketplace 命令) | **`npx superpowers-zh` 一條命令自動識別專案裡的工具並安裝**;識別不出可 `--tool <name>` 顯式指定 |
|
|
130
134
|
| 🇨🇳 Git 平台 | GitHub 為主 | GitHub + Gitee + Coding + 極狐 GitLab + **CNB(騰訊雲原生建置)** |
|
|
131
135
|
| 🇨🇳 CI/CD 範例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 極狐 CI + `.cnb.yml` |
|
|
@@ -140,9 +144,9 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
|
|
|
140
144
|
| 💬 社群 | Discord | 微信公眾號「AI不止語」+ 微信群 + QQ 群 |
|
|
141
145
|
| 📜 License | MIT | MIT |
|
|
142
146
|
|
|
143
|
-
**一句話總結:** 英文上游 = 方法論核心;中文增強版 = 方法論核心 **+**
|
|
147
|
+
**一句話總結:** 英文上游 = 方法論核心;中文增強版 = 方法論核心 **+** 26 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。
|
|
144
148
|
|
|
145
|
-
### 🤖 支援
|
|
149
|
+
### 🤖 支援 26 款主流 AI 編程工具
|
|
146
150
|
|
|
147
151
|
| 工具 | 類型 | 一鍵安裝 | 手動安裝 |
|
|
148
152
|
|------|------|:---:|:---:|
|
|
@@ -169,6 +173,9 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
|
|
|
169
173
|
| [Cline](https://cline.bot) | IDE 外掛 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` |
|
|
170
174
|
| [Kilo Code](https://kilo.ai) | IDE 外掛 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` |
|
|
171
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`) |
|
|
172
179
|
|
|
173
180
|
> 執行 `npx superpowers-zh` 會自動偵測你專案中使用的工具,將 20 個 skills 安裝到正確位置。
|
|
174
181
|
|
|
@@ -231,7 +238,7 @@ npx superpowers-zh --global --tool claude # 或指定工具
|
|
|
231
238
|
|
|
232
239
|
全域安裝把 skills 裝到工具的**使用者級目錄**(如 `~/.claude/skills`),一次安裝所有專案自動可用,更新時也只需重裝一次。**專案級優先、全域兜底**,二者可共存。
|
|
233
240
|
|
|
234
|
-
支援通用全域安裝的工具(均為 docs 已證實的使用者級載入路徑):**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent · CodeBuddy · CodeArts**。其中 **Codex CLI** 全域裝到 `~/.agents/skills`(Codex
|
|
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`。
|
|
235
242
|
|
|
236
243
|
| | 專案級(預設) | 全域(`--global`) |
|
|
237
244
|
|---|---|---|
|
|
@@ -439,10 +446,39 @@ MIT License — 自由使用,商業或個人均可。
|
|
|
439
446
|
|
|
440
447
|
---
|
|
441
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
|
+
|
|
442
466
|
<div align="center">
|
|
443
467
|
|
|
444
|
-
**🦸 AI 編程超能力:讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等
|
|
468
|
+
**🦸 AI 編程超能力:讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具真正會幹活**
|
|
445
469
|
|
|
446
470
|
[Star 本專案](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [貢獻程式碼](https://github.com/jnMetaCode/superpowers-zh/pulls)
|
|
447
471
|
|
|
448
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/RELEASE-NOTES.zh.md
CHANGED
|
@@ -6,6 +6,225 @@
|
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
+
## v1.7.12 (2026-09-07)
|
|
10
|
+
|
|
11
|
+
**通过 Claude Code 插件市场安装的用户请更新。** 本版修的是一个「装了,但技能之间互相调不动」的问题,
|
|
12
|
+
并新增三款工具支持:**ZCode(智谱)**、**DeepSeek Harness** 与 **Reasonix**,工具数 23 → 26。
|
|
13
|
+
|
|
14
|
+
### 🐛 插件模式下跨技能调用全部失败([#116 之外最实的一条:#124](https://github.com/jnMetaCode/superpowers-zh/issues/124))
|
|
15
|
+
|
|
16
|
+
报告人给的证据完整到可以直接复现(v1.7.10 / 插件市场安装 / Windows):
|
|
17
|
+
|
|
18
|
+
Skill("superpowers:systematic-debugging") -> Unknown skill
|
|
19
|
+
Skill("superpowers-zh:systematic-debugging") -> 正常加载
|
|
20
|
+
|
|
21
|
+
Claude Code 按「**<插件名>:<技能名>**」注册插件技能,而本插件在
|
|
22
|
+
`.claude-plugin/plugin.json` 里叫 `superpowers-zh`。可我们的 skill 正文里照抄了上游的
|
|
23
|
+
`superpowers:` 前缀 —— 实测全仓 `superpowers-zh:` **0 处**、`superpowers:` **32 处**,
|
|
24
|
+
分布在 11 个文件。凡是 skill A 让你去用 skill B 的地方,插件用户都会撞上 Unknown skill。
|
|
25
|
+
|
|
26
|
+
**但没有按报告里建议的换成 `superpowers-zh:`。** 本 fork 有两条分发路径,命名空间不同:
|
|
27
|
+
|
|
28
|
+
| 分发方式 | 技能怎么调 |
|
|
29
|
+
|---|---|
|
|
30
|
+
| 插件市场 | `superpowers-zh:<name>` |
|
|
31
|
+
| `npx superpowers-zh` → `.claude/skills/` | **裸名**(项目级技能) |
|
|
32
|
+
|
|
33
|
+
证据是安装器自己生成的 bootstrap —— 它列的就是裸名。也就是说那 32 处**在两种模式下
|
|
34
|
+
都是错的**;只改成 `superpowers-zh:` 等于修好插件模式、又给主分发路径挖一个反向的坑。
|
|
35
|
+
|
|
36
|
+
改成**裸技能名**:npx 模式直接正确;插件模式下模型按后缀匹配得到
|
|
37
|
+
`superpowers-zh:xxx`,而不是照着一个确定不存在的全限定名去调。
|
|
38
|
+
|
|
39
|
+
另有 1 处特例:`copilot-tools.md` 里那句是举例说明「插件智能体」的命名形式,且
|
|
40
|
+
`code-reviewer` 在本 fork 根本不是技能,改成通用写法 `<插件名>:<智能体名>`。
|
|
41
|
+
|
|
42
|
+
### 🐛 Crush 在 Windows 上装到了它不扫描的目录
|
|
43
|
+
|
|
44
|
+
[Crush README](https://github.com/charmbracelet/crush) 的 Agent Skills 一节写明
|
|
45
|
+
Windows 走 `%LOCALAPPDATA%\crush\skills\`(它给 Windows 用户的上手命令就是
|
|
46
|
+
`mkdir "$env:LOCALAPPDATA\crush\skills"`),而我们两个平台都装 `~/.config/crush/skills`。
|
|
47
|
+
|
|
48
|
+
**而我们自己的 `docs/README.crush.md` 早就写对了** —— 又一次「文档描述的是意图,
|
|
49
|
+
代码做的是另一回事」,与 v1.7.10 修 Aider 时同一句话。
|
|
50
|
+
|
|
51
|
+
`global` 支持可选的 `dirWin`,按平台选路。OpenCode 的 `.config/` **没动**:其官方文档
|
|
52
|
+
没有任何 Windows 专属说明,没证据就不猜路径。
|
|
53
|
+
|
|
54
|
+
### 🐛 render-graphs.js:取上游的两处修复,但不跟它改 ESM
|
|
55
|
+
|
|
56
|
+
上游 v6.3.0 改了三处,我们只取两处:
|
|
57
|
+
|
|
58
|
+
| 上游改动 | 我们 | 理由 |
|
|
59
|
+
|---|---|---|
|
|
60
|
+
| `execSync('dot -Tsvg')` → `execFileSync('dot', [...])` | ✅ | 安全加固,不过 shell |
|
|
61
|
+
| `execSync('which dot')` → `execFileSync('dot', ['-V'])` | ✅ | **Windows 修复** —— `which` 在 Windows 上不是命令 |
|
|
62
|
+
| CommonJS → ESM | ❌ | 这脚本会被拷进**用户项目**执行,Node 判定模块类型看用户项目的 package.json。Node 22.7+ 有 ESM 自动探测所以看不出问题,但本仓 engines 是 `node>=20`,Node 20 无探测,在普通 CommonJS 项目里直接加载失败 |
|
|
63
|
+
|
|
64
|
+
实测(`--no-experimental-detect-command` 模拟 Node 20):上游版报
|
|
65
|
+
`To load an ES module, set "type": "module"` + SyntaxError,我们改后版本正常执行。
|
|
66
|
+
|
|
67
|
+
### 🔄 对齐上游 v6.3.0:13 个镜像文件、+415 / -44 行正文
|
|
68
|
+
|
|
69
|
+
旧门禁对已翻译的文件只比「标题数」—— 标题不变,正文改多少行都看不见。上游 v6.3.0
|
|
70
|
+
给 skill 正文加了 415 行,我们这边一声不吭。这一版补了基线文件
|
|
71
|
+
`.upstream-sync.json` 之后,第一次量出了这个缺口,并分四批补完:
|
|
72
|
+
|
|
73
|
+
| 文件 | 上游改动 | 这次同步了什么 |
|
|
74
|
+
|---|---|---|
|
|
75
|
+
| `brainstorming/SKILL.md` | +108 / -9 | 重译到 v6.3.0:Three Paths 结构、危险信号表、每条路径各自的检查清单 |
|
|
76
|
+
| `using-superpowers/references/codex-tools.md` | +70 / -1 | 我们原来只有 2 节 25 行,上游是 5 节;顺带修掉 `close_agent` 在 V1/V2 里的错误行 |
|
|
77
|
+
| `using-superpowers/references/hermes-tools.md` | +56 | 换成上游的 6 节版本,只保留一条声明过的 fork 注记 |
|
|
78
|
+
| `finishing-a-development-branch/SKILL.md` | +24 | 工作树删除被拒时的处理:绝不自作主张 `--force` |
|
|
79
|
+
| `implementer-prompt.md` / `re-review-prompt.md` / `code-reviewer.md` | +30 | 三份子智能体提示词统一加上「**你不派发子智能体**」契约 |
|
|
80
|
+
| `subagent-driven-development/SKILL.md` | +89 / -24 | 控制者从「遇事问人」改成「**自行裁决 + 记账**」(见下) |
|
|
81
|
+
| `task-reviewer-prompt.md` | +22 | 审查者不派子智能体;证据读不到 ≠ 证据不存在;打包分派要逐文件对 diff |
|
|
82
|
+
| `writing-plans/SKILL.md` / `using-superpowers/SKILL.md` / `visual-companion.md` | +9 / -4 | 计划模板新增 Spec 字段;Hermes 工具参考入口;Copilot CLI 后台启动说明 |
|
|
83
|
+
|
|
84
|
+
其中 SDD 那条是行为塑造上最实的一处改动。旧版本里,控制者一遇到「审查发现」与
|
|
85
|
+
「计划原文」冲突就停下来问人类伙伴;v6.3.0 改成由控制者自己裁决,每条裁决以
|
|
86
|
+
`Ruling: <决定> — <为什么> — <错了的代价>` 记进账本,收尾时汇总成「我作出的裁决」
|
|
87
|
+
交回来。只留四类硬停止:不可逆或破坏性操作、涉及安全的动作、工作树之外按惯例
|
|
88
|
+
该先问一声的副作用(合并 / 推送共享分支 / 发布)、以及坏到每条路都只能靠猜的计划。
|
|
89
|
+
理由是上游写在正文里的一句话:**一个错误的裁决,代价是看得见也撤得掉的返工;
|
|
90
|
+
一个停在问题上的会话,代价是一整天,而且什么也换不来。**
|
|
91
|
+
|
|
92
|
+
配套的流程图节点也跟着改了(「询问人类伙伴以哪个为准」→「对冲突作出裁决,把裁决
|
|
93
|
+
记进账本」),预检扫描的产出从一句结论改成一张必须逐行填的表。
|
|
94
|
+
|
|
95
|
+
**唯一有意不同步的是 `writing-skills/render-graphs.js` 的 CJS → ESM**,理由见上一节。
|
|
96
|
+
这条分歧写进了 `.upstream-sync.json` 的 evidence 字段,免得下次同步时被当成遗漏又"修"一遍。
|
|
97
|
+
|
|
98
|
+
### 🆕 新增 ZCode(智谱)支持 —— 只做全局,因为项目级路径官方从未公开([#95](https://github.com/jnMetaCode/superpowers-zh/issues/95) [#120](https://github.com/jnMetaCode/superpowers-zh/issues/120))
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
npx superpowers-zh --global --tool zcode # -> ~/.zcode/skills/
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
[#120](https://github.com/jnMetaCode/superpowers-zh/issues/120) 附了一份完整补丁,写着装到
|
|
105
|
+
`.zcode/skills` + 写 `.zcode/AGENTS.md`。**没有采纳** —— 提交者自己写明那是「让 AI 按
|
|
106
|
+
zcode 的目录结构适配」生成的,而官方文档里查无此路径。
|
|
107
|
+
|
|
108
|
+
[ZCode 官方技能文档](https://zcode.z.ai/docs/skill)(中英文版一致)只给出一个磁盘路径:
|
|
109
|
+
|
|
110
|
+
ZCode Agent 的用户级技能目录:~/.zcode/skills/<skill-name>/SKILL.md
|
|
111
|
+
|
|
112
|
+
项目级在文档里是**应用内的 UI 导入动作**(设置 → 技能 → 导入,可选「链接到来源目录」或
|
|
113
|
+
「复制成 ZCode 内部副本」,导入目标可选「全局」或「当前项目」),**从不暴露项目级磁盘
|
|
114
|
+
路径**。`.zcode/AGENTS.md` 同样查无实据 —— AGENTS.md 在 ZCode 里确实是六类扩展之一,
|
|
115
|
+
但位置与作用域文档页没写明。
|
|
116
|
+
|
|
117
|
+
所以项目级安装被**明确拒绝**(退出码 1、项目里零写入),并指向 `--global`:
|
|
118
|
+
|
|
119
|
+
❌ ZCode 不支持项目级安装。
|
|
120
|
+
其官方文档只给出用户级技能目录,项目级导入是应用内的 UI 动作、不暴露磁盘路径。
|
|
121
|
+
猜一个路径装进去只会「装了不生效」,所以这里直接拒绝。
|
|
122
|
+
|
|
123
|
+
猜路径的代价这仓已经付过三次(Codex 项目级、Windsurf 全局、VS Code),这次不付第四次。
|
|
124
|
+
|
|
125
|
+
技能装好后在 ZCode 里用 `$skill-name` 调用(设置 → 技能 里可查看与启停)。因为不写
|
|
126
|
+
bootstrap,**不会自动触发**,需要显式调用 —— 这个限制写在 `docs/README.zcode.md` 里。
|
|
127
|
+
若你查到 ZCode 的项目级路径或 AGENTS.md 的确切位置,欢迎开 issue,我们会补上。
|
|
128
|
+
|
|
129
|
+
工具数 23 → **24**,支持全局安装的工具 11 → **12**。
|
|
130
|
+
|
|
131
|
+
### 🆕 新增 DeepSeek Harness(dsh)支持([#122](https://github.com/jnMetaCode/superpowers-zh/issues/122))
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
npx superpowers-zh # 自动检测 .dsh/
|
|
135
|
+
npx superpowers-zh --global --tool dsh # -> ~/.dsh/skills/ + ~/.dsh/AGENTS.md
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
与 ZCode 相反,这款**四条路径全部有一手出处**,所以项目级与全局都支持:
|
|
139
|
+
|
|
140
|
+
| 内容 | 路径 | 出处 |
|
|
141
|
+
|---|---|---|
|
|
142
|
+
| skills(项目级) | `.dsh/skills/` | `docs/subsystems/skills.md` 的 Local discovery priority 表 rank 100 |
|
|
143
|
+
| skills(全局) | `~/.dsh/skills/` | shell-env 文档:`dshHome \| $DSH_HOME, then ~/.dsh` |
|
|
144
|
+
| 引导(项目级) | 项目根 `AGENTS.md` | `instructionFileCandidates` 默认 `['AGENTS.md', 'CLAUDE.md']` |
|
|
145
|
+
| 引导(全局) | `~/.dsh/AGENTS.md` | user-global 指令文件为 `$DSH_HOME/AGENTS.md` |
|
|
146
|
+
|
|
147
|
+
**装过 Antigravity 或 Codex 的项目其实已经被覆盖一半**:dsh 的技能发现 rank 200 是
|
|
148
|
+
`.agents/skills`,正是那两款用的目录。文档里写明了别重复装。同理 dsh 也读 `CLAUDE.md`,
|
|
149
|
+
装过 Claude Code 的项目引导那半已生效 —— 但 `.claude/skills` 不在 dsh 的技能根列表里,
|
|
150
|
+
技能仍需单独装。
|
|
151
|
+
|
|
152
|
+
### 🆕 新增 Reasonix 支持([#42](https://github.com/jnMetaCode/superpowers-zh/issues/42))
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
npx superpowers-zh # 自动检测 .reasonix/ 或 reasonix.toml
|
|
156
|
+
npx superpowers-zh --global --tool reasonix
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
[Reasonix](https://reasonix.io/)(esengine/DeepSeek-Reasonix)是 DeepSeek 原生的终端 coding
|
|
160
|
+
agent。#42 的 issue 模板整个没填,但产品是真实存在的,官方文档也齐全:
|
|
161
|
+
|
|
162
|
+
| 内容 | 路径 | 出处 |
|
|
163
|
+
|---|---|---|
|
|
164
|
+
| skills(项目级) | `.reasonix/skills/` | `docs/CONFIG_PATHS.zh-CN.md`:项目本地 settings / skills / commands 位于项目 `.reasonix/` |
|
|
165
|
+
| skills(全局 macOS/Linux) | `~/.reasonix/skills/` | 同上:全局 skills = `<Reasonix home>/skills/` |
|
|
166
|
+
| skills(全局 **Windows**) | `%APPDATA%\reasonix\skills\` | 同上 Reasonix home 表:Windows 为 `%APPDATA%\reasonix`,**与 Unix 不同构** |
|
|
167
|
+
| 引导(项目级) | 项目根 `REASONIX.md` | `docs/GUIDE.zh-CN.md`:常驻指令分层加载 `REASONIX.md` / `AGENTS.md` / `CLAUDE.md` |
|
|
168
|
+
|
|
169
|
+
Windows 路径走上一版为 Crush 加的 `dirWin` 机制。**全局安装不写引导文件**:官方说
|
|
170
|
+
「用户全局文件先加载」但没写明那个文件的确切路径,不确认就不写 —— 全局仍装 skills,
|
|
171
|
+
只是不自动触发,想要自动触发用项目级安装。
|
|
172
|
+
|
|
173
|
+
### 🐛 在管理员 PowerShell 里跑,会把 skills 装进 C:\Windows\System32([#125](https://github.com/jnMetaCode/superpowers-zh/issues/125))
|
|
174
|
+
|
|
175
|
+
issue 正文只有一张截图、模板全空。但那张截图把事情说清楚了:
|
|
176
|
+
|
|
177
|
+
PS C:\Windows\system32> npx superpowers-zh --tool trae
|
|
178
|
+
模式: 项目级
|
|
179
|
+
目标: C:\Windows\System32
|
|
180
|
+
✅ Trae [项目]: 20 个 skills -> C:\Windows\System32\.trae\skills
|
|
181
|
+
✅ Trae: bootstrap rule -> C:\Windows\System32\.trae\rules\superpowers-zh.md
|
|
182
|
+
|
|
183
|
+
**管理员权限打开的 PowerShell,默认工作目录就是 `C:\Windows\System32`。** 用户在那里
|
|
184
|
+
直接跑 npx,我们就老老实实把 20 个 skill 目录写进了 Windows 系统目录。
|
|
185
|
+
|
|
186
|
+
我们本来就有「拒绝装进用户主目录」的护栏(`--force` 可绕过),却从没拦过系统目录。
|
|
187
|
+
现在补上,且**不提供 --force 绕过** —— 装到系统目录没有任何正当用途,给个开关只会
|
|
188
|
+
让人照着开关走。
|
|
189
|
+
|
|
190
|
+
⚠️ 当前目录是系统目录: C:\Windows\System32
|
|
191
|
+
常见原因:**用管理员权限打开的 PowerShell / cmd,默认工作目录就是
|
|
192
|
+
C:\Windows\System32**,直接在里面跑 npx 就会装到这里(issue #125)。
|
|
193
|
+
正确做法 —— 先切到你的项目目录: cd D:\path\to\your\project
|
|
194
|
+
|
|
195
|
+
覆盖 Windows(`%SystemRoot%`、`%ProgramFiles%`、`%ProgramData%`、盘符根)与
|
|
196
|
+
Unix(`/`、`/usr`、`/etc`、`/bin`、`/sbin`、`/var`、`/opt`、`/System`、`/Library`)。
|
|
197
|
+
主目录与系统临时目录豁免(各有自己的处理)。
|
|
198
|
+
|
|
199
|
+
> 关于截图里那个「检测到当前版本文件损坏」弹窗:那是 TRAE 自己的完整性检查提示,
|
|
200
|
+
> **我们没有证据表明它是本次安装导致的**,所以不宣称因果。能确认并已修的是:
|
|
201
|
+
> 我们不该往系统目录写东西。
|
|
202
|
+
|
|
203
|
+
### 🛡️ 这一版新增 / 修好的门禁
|
|
204
|
+
|
|
205
|
+
每条都做过反向验证(把问题造回去,必须报错):
|
|
206
|
+
|
|
207
|
+
| 门禁 | 堵的是 |
|
|
208
|
+
|---|---|
|
|
209
|
+
| skill 正文禁止出现 `superpowers:` 前缀 | 上游正文里全是它,每次同步都会带回来 |
|
|
210
|
+
| Windows 专属全局路径(platform 打桩跑真实代码) | 「只在某个平台不生效」的 bug,在 macOS 上跑一万次也测不出 |
|
|
211
|
+
| 11 款全局工具卸载零残留 + **不误删用户自有文件** | 此前只测了 1 款;「误删」一款都没测过 |
|
|
212
|
+
| 上游同步基线 `.upstream-sync.json` + 正文级漂移计量 | 上游改了 415 行正文,旧门禁一个字都没说 |
|
|
213
|
+
| 全局-only 工具的项目级必须明确拒绝(rc≠0 + 零写入) | 猜一个项目级路径装进去 = 第四次「装了不生效」 |
|
|
214
|
+
| 系统目录护栏(Unix + win32 打桩双向验证) | 管理员终端默认 cwd 就是 System32(#125) |
|
|
215
|
+
| audit 3c-bis 的静默分支改为显式 warn | 上游一发新版,检查条数就悄悄少一条 |
|
|
216
|
+
|
|
217
|
+
`verify-release` 115 → **163 pass**,`audit` 162 pass / 0 warn。
|
|
218
|
+
|
|
219
|
+
### 🌐 官网(不影响安装包)
|
|
220
|
+
|
|
221
|
+
本版官网侧改动较多,逐条见提交历史:版本提示条(此前站上对「谁该重装」零表述)、
|
|
222
|
+
22 份工具文档入口、JSON-LD 结构化数据、1200×630 分享大图、可访问性修复
|
|
223
|
+
(57 个页面两个 h1 / 搜索框焦点被抹掉 / 全站无 skip link)、sitemap 的 lastmod
|
|
224
|
+
不再谎报「今天改的」、抖音二维码 177 KB → 31 KB。
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
9
228
|
## v1.7.11 (2026-08-28)
|
|
10
229
|
|
|
11
230
|
**Codex CLI / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 用户请重新安装。**
|
|
Binary file
|
|
Binary file
|
|
Binary file
|