chore(release): v1.7.11 —— 剩下没查过的工具全查完了,又是四款「装了完全不生效」

v1.7.10 查出三款装错,当时的结论是「既然错过一次,就该问一句还有几个」。这一版
把剩下的逐款对官方文档核完(拿不到文档的对源码)。

答案:又是四款装了完全不生效,全部是我们自己写的路径、全部没查过官方文档。

## 必须重装的六款

| 工具 | 问题 |
|---|---|
| Codex CLI | 项目级装到 `.codex/skills`,官方扫描清单里从来没有这个目录 |
| VS Code (Copilot) | 20 个文件 Copilot 一个都不读,且不写任何引导 |
| Windsurf | `--global` 装到 `~/.windsurf/skills`,官方是 `~/.codeium/windsurf/skills/` |
| DeerFlow | 检测标记 `deer_flow` 在真实仓库里不存在,从没被自动检测到过 |
| Qwen Code | 无 bootstrap(skill 是死重);文档还把它跟通义灵码搞混了 |
| Claw Code | 无 bootstrap、且是 23 款里唯一没有安装文档的一款 |

## 其余

- CodeBuddy / CodeArts 拿到官方用户级路径出处,补 `--global`(全局支持 9 → 11 款)
- 4 条死链,其中 2 条是编造出来的仓库地址(`anthropics/openclaw`、
  `anthropics/antigravity` 都不存在)
- 官网工具墙停在 20 款:Cline / Kilo Code / Crush 的用户在下拉里找不到自己的工具;
  skill 详情页 6 条死链;新增赞助商页
- 5 条新门禁,全部做过反向验证:全局落盘位置、外链验活、官网工具列表条目数、
  官网全局清单覆盖、两条 shell 静默失效坑

## 版本号

`v1.7.11 起…` 这句话此前散在 8 处文档里,而 package.json 还停在 1.7.10 ——
用户装到的版本里根本没有那些修复。7 个声明文件经 scripts/sync-plugin-version.js
同步到 1.7.11,两版 README 的更新亮点块换成本版内容。

## 发版前全量验证(全绿)

| 项 | 结果 |
|---|---|
| `scripts/audit.sh` | 170 pass / 0 warn / 0 fail |
| `scripts/verify-release.sh` | 115 pass / 0 fail |
| CI 等价检查(frontmatter / package.json / --help) | 20 skills 0 error,v1.7.11 |
| tests/kimi · pi · opencode · brainstorm-server | 全 PASS(6 / 1 / 32 用例) |
| 官网 66 页构建 + 全站链接扫描 | 站内死链 0,无效 `href="#"` 0 |
| 官网给出的 23 条安装命令逐条实跑 | 19 款自动检测 + 4 款显式命令,各装 20 skills ✓ |
This commit is contained in:
AI不止语
2026-08-28 22:37:53 +08:00
parent c7713cac65
commit d937312202
10 changed files with 152 additions and 19 deletions

View File

@@ -9,7 +9,7 @@
{
"name": "superpowers-zh",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具",
"version": "1.7.10",
"version": "1.7.11",
"source": "./",
"author": {
"name": "jnMetaCode",

View File

@@ -1,7 +1,7 @@
{
"name": "superpowers-zh",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具",
"version": "1.7.10",
"version": "1.7.11",
"author": {
"name": "jnMetaCode",
"url": "https://github.com/jnMetaCode"

View File

@@ -1,6 +1,6 @@
{
"name": "superpowers-zh",
"version": "1.7.10",
"version": "1.7.11",
"description": "AI 编程超能力中文增强版头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流附 4 个中文 skills 沉淀。",
"author": {
"name": "jnMetaCode",

View File

@@ -2,7 +2,7 @@
"name": "superpowers-zh",
"displayName": "Superpowers 中文版",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 23 款工具",
"version": "1.7.10",
"version": "1.7.11",
"author": {
"name": "jnMetaCode",
"url": "https://github.com/jnMetaCode"

View File

@@ -1,6 +1,6 @@
{
"name": "superpowers-zh",
"version": "1.7.10",
"version": "1.7.11",
"description": "AI 编程超能力中文增强版头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流附 4 个中文 skills 沉淀。",
"author": {
"name": "jnMetaCode",

View File

@@ -16,14 +16,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
>
> 🌍 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)
> 🆕 **v1.7.10 更新亮点** —— **Aider / Kiro / Hermes 用户请重装**(此前装了等于没装):
> 🆕 **v1.7.11 更新亮点** —— **Codex / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 用户请重装**(此前装了等于没装):
>
> - 🐛 **Aider** —— 真实 Aider 项目从来没被自动检测到过(它不创建 `.aider/` 目录),且 `CONVENTIONS.md` **不会**被自动加载(官方要求 `--read`)。现在检测认真实标记,装完打印激活命令
> - 🐛 **Kiro** —— `.kiro/steering/` 下的文件**每轮对话全量进上下文**,而我们把 20 个 skill 正文全塞了进去:实测 **335 KB/轮**。改为索引式后 **4.4 KB**76 倍),重装会自动清旧布局
> - 🐛 **Hermes** —— 之前只装项目级 `.hermes/skills/`,而 Hermes 根本不读那个目录。现在改用 `npx superpowers-zh --global --tool hermes` 装到 `~/.hermes/skills/`
> - 🆕 **新增 Crush**(工具数 22 → 23—— 若你已为 CC / Cursor / Codex 装过Crush 其实已经能读到,别重复装
> - 🐛 **Codex CLI** —— 项目级装到 `.codex/skills`,而官方扫描清单里**从来没有这个目录**。改为 `.agents/skills`,重装会自动清旧位置
> - 🐛 **VS Code (Copilot)** —— 装的 20 个文件 Copilot 一个都不读,且不写任何引导。现在生成 `.github/instructions/superpowers-zh.instructions.md``applyTo: "**"`
> - 🐛 **Windsurf** —— `--global` 装到 `~/.windsurf/skills`,官方用户级路径是 `~/.codeium/windsurf/skills/`。全局装过的请重装
> - 🆕 **Qwen Code / Claw Code 补 bootstrapCodeBuddy / CodeArts 补 `--global`**(全局支持 9 → 11 款)
>
> 📋 其余改动(Qoder 工具映射表更正、上游 v6.2.0 对齐、测试盲区补齐、Windows bootstrap 修复、SDD 同步…)见 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
> 📋 其余改动(DeerFlow 检测标记、4 条死链含 2 条编造的仓库地址、官网工具墙 20 → 23、5 条新门禁…)见 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
### 📊 项目规模

View File

@@ -16,14 +16,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
> 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費
> 🆕 **v1.7.10 更新亮點** —— **Aider / Kiro / Hermes 使用者請重裝**(此前裝了等於沒裝):
> 🆕 **v1.7.11 更新亮點** —— **Codex / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 使用者請重裝**(此前裝了等於沒裝):
>
> - 🐛 **Aider** —— 真實 Aider 專案從來沒被自動偵測到過(它不建立 `.aider/` 目錄),且 `CONVENTIONS.md` **不會**被自動載入(官方要求 `--read`)。現在偵測認真實標記,裝完列印啟用命令
> - 🐛 **Kiro** —— `.kiro/steering/` 下的檔案**每輪對話全量進上下文**,而我們把 20 個 skill 正文全塞了進去:實測 **335 KB/輪**。改為索引式後 **4.4 KB**76 倍),重裝會自動清舊佈局
> - 🐛 **Hermes** —— 之前只裝專案級 `.hermes/skills/`,而 Hermes 根本不讀那個目錄。現在改用 `npx superpowers-zh --global --tool hermes` 裝到 `~/.hermes/skills/`
> - 🆕 **新增 Crush**(工具數 22 → 23—— 若你已為 CC / Cursor / Codex 裝過Crush 其實已經能讀到,別重複裝
> - 🐛 **Codex CLI** —— 專案級裝到 `.codex/skills`,而官方掃描清單裡**從來沒有這個目錄**。改為 `.agents/skills`,重裝會自動清舊位置
> - 🐛 **VS Code (Copilot)** —— 裝的 20 個檔案 Copilot 一個都不讀,且不寫任何引導。現在產生 `.github/instructions/superpowers-zh.instructions.md``applyTo: "**"`
> - 🐛 **Windsurf** —— `--global` 裝到 `~/.windsurf/skills`,官方使用者級路徑是 `~/.codeium/windsurf/skills/`。全域裝過的請重裝
> - 🆕 **Qwen Code / Claw Code 補 bootstrapCodeBuddy / CodeArts 補 `--global`**(全域支援 9 → 11 款)
>
> 📋 其餘改動(Qoder 工具對映表更正、上游 v6.2.0 對齊、測試盲區補齊、Windows bootstrap 修復、SDD 同步…)見 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
> 📋 其餘改動(DeerFlow 偵測標記、4 條死連結含 2 條編造的儲存庫地址、官網工具牆 20 → 23、5 條新門禁…)見 **[完整 Release Notes →](RELEASE-NOTES.zh.md)**
### 📊 專案規模

View File

@@ -6,6 +6,139 @@
---
## v1.7.11 (2026-08-28)
**Codex CLI / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 用户请重新安装。**
v1.7.10 那次核查查出三款装错,当时的结论是「既然错过一次,就该问一句还有几个」。这一版把**剩下没查过的全部查完了** —— 逐款对官方文档(拿不到文档的对源码),一款一款过。
结果:又是四款「装了完全不生效」。都是我们自己写的路径,都没查过官方文档。
### 🐛 Codex CLI项目级装到了 Codex 从不扫描的目录
[官方 skills 文档](https://developers.openai.com/codex/skills)给出的扫描目录**完整清单**
$CWD/.agents/skills、$CWD/../.agents/skills、$REPO_ROOT/.agents/skills
$HOME/.agents/skills、/etc/codex/skills、内置 skill
**没有 `.codex/skills`。** 而我们项目级正是装到那里。
讽刺的是全局(`~/.agents/skills`)一直是对的,原注释还专门写明「不是 `~/.codex/skills`」—— 说明当初查过全局,却没顺手核一下项目级。
已改为 `.agents/skills`,并在安装时清理旧位置(只清我们装的,用户自己放在 `.codex/skills` 下的不动,已实测)。与 Antigravity 共用 `.agents/skills` 是 Agent Skills 开放约定,不是冲突。
**这个改动还牵出一个既有 bug自动检测有顺序依赖。** 检测原来是边装边判的 —— Codex 装完会创建 `.agents/`,循环走到 Antigravity`detect: '.agents'`)时它就被误判成「项目里有这个工具」,于是多装一份。任何「装了 A 会创建 B 的检测标记」的组合都会中招。改为**先把所有工具的检测结果一次算完再开始装**:检测必须基于安装前的项目状态。
### 🐛 VS Code (Copilot):装的 20 个文件Copilot 一个都不读
[官方文档](https://code.visualstudio.com/docs/copilot/customization/custom-instructions)明确 Copilot 只自动读这几处:
.github/copilot-instructions.md / AGENTS.md / CLAUDE.md (始终生效)
.github/instructions/*.instructions.md (按 applyTo 匹配)
我们把 20 个 skill 拷进 `.github/superpowers/` —— **不在其中**,而且装完什么引导都不写。
旧文档更说明问题:它写着「建议你创建 `.github/copilot-instructions.md` 引用这些 skills」并给了示例 —— **我们知道需要引导,却让用户自己动手**,而绝大多数人不会照做。
现在自动生成 `.github/instructions/superpowers-zh.instructions.md``applyTo: "**"`,约 4.5 KB 的索引),正文仍留在 `.github/superpowers/` 按需读取 —— 与 Cline / Kilo / Kiro 同一套「常驻只放索引」的思路。**刻意不动用户的 `copilot-instructions.md`**,那是他们的文件。
### 🐛 Windsurf`--global` 装在 Windsurf 不读的地方
[官方文档](https://docs.windsurf.com/windsurf/cascade/skills)写明两个路径**不同构**
| | 路径 |
|---|---|
| 项目级 | `.windsurf/skills/<name>/` ✅ 我们是对的 |
| 用户级 | `~/.codeium/windsurf/skills/<name>/` ❌ 我们装到了 `~/.windsurf/skills` |
**测试为什么没抓到:只验退出码,不验落盘位置。** 装到错目录退出码照样是 0 —— 「跑通了」不等于「装对了」。已补 `GLOBAL_DIR` 断言:每款全局工具逐个断言 skill 真落在官方读的那个目录,外加一条自检(以后加全局工具不能漏断言)。双向验证过:把路径改回旧值立刻报错。
### 🐛 DeerFlow检测标记根本不存在Aider 同款)
安装路径 `skills/custom/` 是对的(官方文档确认自动扫描 `["skills/public", "skills/custom"]` 两个写死的目录)。但 `detect` 写的是 `deer_flow` —— 用 GitHub API 列了 deer-flow main 分支顶层目录:
.agent .github backend contracts deploy docker docs frontend plans
pr-build scripts skills tests
**没有 `deer_flow`。** 与 Aider 的 `.aider` 是同一个毛病:真实检出从来没被自动检测到过。改认 `skills/public`skills 机制本身、随仓库版本控制,任何检出都有),`deer_flow` 保留作 1.x 兼容。
顺带删掉文档里那段 `export DEERFLOW_SKILLS_DIR=...` —— **官方文档里没有这个环境变量**,目录是写死的。
### 🐛 Qwen Code缺 bootstrapskill 是死重)+ 我们把产品搞混了
路径是对的,但两个问题:
**① 产品搞混。** 文档标题写「Qwen Code (通义灵码)」、链接指向 `tongyi.aliyun.com`。实际 Qwen Code 是 [QwenLM/qwen-code](https://github.com/QwenLM/qwen-code) 这个**命令行工具**Gemini CLI 的 fork通义灵码是阿里的 IDE 插件,**是另一个产品**,路径完全不同 —— 照我们的文档去配通义灵码是配不通的。与 [#119](https://github.com/jnMetaCode/superpowers-zh/issues/119) 的 Qoder 表是同一类错误:把两个产品面混成一份说明。
**② 只装 skills、不写 bootstrap。** Claude 写 `CLAUDE.md`、Gemini 写 `GEMINI.md`,而 Qwen Code 的对应物 `QWEN.md` 我们完全没用。按上游的原则:没有 bootstrapskill 就是死重 —— 文件在磁盘上但很少被调用。已补(项目级写 `./QWEN.md`,全局写 `~/.qwen/QWEN.md`,已有文件用哨兵注释追加而非覆盖),并补上全局卸载的残留缺口。
### 🆕 Claw Code补 bootstrap + 补文档23 款里唯一没有安装文档的一款)
路径拿到了源码级证据(`ultraworkers/claw-code``rust/crates/plugins/src/lib.rs` 明写发现 `.claw/skills``.omc/skills``.agents/skills``USAGE.md` 列出指令文件优先级 `CLAUDE.md > CLAW.md > AGENTS.md`)。补上 `CLAW.md` bootstrap 与 `docs/README.claw.md`并写明一条实用提醒claw 也扫 `.agents/skills`,装过 Antigravity 的项目其实已经能读到,重复装会加载两份。
### 🆕 CodeBuddy / CodeArts 补 `--global`(全局支持 9 → 11 款)
两款的用户级路径此前都写着「尚未验证」,现已拿到官方出处:
| 工具 | 用户级路径 | 出处 |
|---|---|---|
| CodeBuddy腾讯 | `~/.codebuddy/skills/` + `~/.codebuddy/CODEBUDDY.md` | [codebuddy.cn/docs/cli/codebuddy-dir](https://www.codebuddy.cn/docs/cli/codebuddy-dir) |
| CodeArts华为云码道 | `~/.codeartsdoer/skills/` | 华为云官方用户指南 |
支持通用全局安装的工具由 9 款增至 **11 款**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent · CodeBuddy · CodeArts。
### 🐛 4 条死链,其中 2 条是编造出来的仓库地址
核查 OpenClaw 时发现文档链的是 `github.com/anthropics/openclaw` —— **那个仓库不存在**。顺手全仓扫了一遍外链45 条里 4 条是死的:
| 原链接 | 状态 | 改为 |
|---|---|---|
| github.com/anthropics/openclaw | 404仓库不存在 | github.com/openclaw/openclaw |
| github.com/anthropics/antigravity | 404且 Antigravity 是**谷歌**的产品 | antigravity.google |
| huaweicloud.com/product/codeartsdoer.html | 404产品页改版 | codearts.huaweicloud.com |
| docs.codeium.com/windsurf | Windsurf 已迁走 | docs.windsurf.com/… |
前两条是**编造出来的出处**。这比没有出处更坏:它让人以为核实过了。已固化成外链验活门禁(两遍制:并行快扫出嫌疑名单,再串行复核,两遍都判死才算死 —— 一个会误报的门禁比没有门禁更糟,人会学会忽略它)。
### 🌐 官网:工具墙停在 20 款,三处文案自己打自己
首页统计块写「20 支持工具」同一屏的标题写「23 款工具通用」FAQ 又枚举了 23 款。根因是文案计数跟着 installer 改到了 23`site/build.mjs` 的工具数组从来没人补 —— **Cline / Kilo Code / Crush 的用户在安装命令下拉里找不到自己的工具**
- 工具列表 20 → 23统计块改成从列表长度算不再硬编码
- 修 4 条错的Claw Code 已能自动检出(不必再 `--tool claw`、Hermes 改给 `--global`项目级给了等于给「装了不生效」、Qwen Code 类型 IDE → CLI、Antigravity 类型 CLI → IDE
- FAQ「支持全局」清单 7 → 11 款(三语同步)
- skill 详情页 **6 条死链**`SKILL.md` 里指向兄弟文件的相对链接(`implementer-prompt.md``../requesting-code-review/code-reviewer.md` 等)站点上没有这些 `.md``../` 开头的 404其余被渲染器打成 `href="#"` —— 点了没反应,比 404 还难查。现在解析到 GitHub 源文件
- 新增赞助商独立页,导航栏补当前页高亮
### 🛡️ 测试与门禁
这一版查出的问题,旧门禁一个都发现不了。逐条补上,并全部做过**反向验证**(把问题造回去,必须报错):
| 新增门禁 | 堵的是 |
|---|---|
| 全局工具落盘位置断言 | Windsurf 那类「退出码 0 但装错目录」 |
| 外链验活(两遍制) | 编造出来的仓库地址 |
| 官网工具列表条目数 = TARGETS + 1 | 官网列表跟不上 installer |
| 官网全局清单必须覆盖每个 `global:` 目标 | FAQ 停在 7 款 |
| `grep -P` / 全角括号吞变量名 两条 shell 坑 | 我自己写出来的静默失效检查 |
`verify-release.sh` 101 → **115 pass**`audit.sh`**170 pass**
### 📋 这一轮六款,六种失效方式
| 工具 | 路径对吗 | 失效方式 |
|---|---|---|
| Codex CLI | ❌ 项目级 | 装到从不被扫描的目录 |
| VS Code | ❌ | 位置不在官方读取清单里,且不写引导 |
| Windsurf | ❌ 仅全局 | 用户级路径与项目级不同构 |
| DeerFlow | ✅ | 检测标记不存在,从没被自动检测到 |
| Qwen Code | ✅ | 无 bootstrapskill 是死重;文档搞混产品 |
| Claw Code | ✅ | 无 bootstrap、无文档 |
**共同点:全部是我们自己写的,全部没查过官方文档。** 现在每条路径在代码注释里都带出处链接与核对结论 —— 下次改之前先看那行注释。
---
## v1.7.10 (2026-08-12)
**Aider 和 Kiro 用户请重新安装。** 本版本源于一次对「我们自己那层工具支持」的系统核查 —— 起因是 v1.7.9 修 Hermes 时发现:我们从支持它起就装错了目录。既然错过一次,就该问一句**还有几个**。

View File

@@ -1,6 +1,6 @@
{
"name": "superpowers-zh",
"description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
"version": "1.7.10",
"version": "1.7.11",
"contextFileName": "GEMINI.md"
}

View File

@@ -1,6 +1,6 @@
{
"name": "superpowers-zh",
"version": "1.7.10",
"version": "1.7.11",
"engines": {
"node": ">=20.0.0"
},