AI 原生开放教材

外观

superpowers-zh（AI 编程超能力 · 中文增强版）技能与配置库·中文原文 ↗原件 ↓仓库 ↗

v1.7.13 (2026-09-08) ​

只有 TRAE 国内版用户需要更新。 处理 #35 时发现 Trae 此前完全没有全局安装，而国内版的全局目录还跟国际版不同构。

🐛 TRAE CN 全局目录是 ~/.trae-cn/skills，不是 ~/.trae/skills ​

TRAE CN 官方文档「技能所在目录」：

作用域路径
全局（macOS/Linux）~/.trae-cn/skills
全局（Windows）%userprofile%/.trae-cn/skills
项目项目所在路径下的 .trae/skills/ 目录

全局是 .trae-cn，差一个后缀就是又一次「装了 20 个文件、工具一个都不读」。而国际版文档没有给出全局路径 —— 按本仓一贯口径不猜，所以国际版不做全局。

bash
npx superpowers-zh --tool trae             # 项目级，两版通用（.trae/skills/）
npx superpowers-zh --global --tool traecn  # 全局，仅国内版（~/.trae-cn/skills/）

别名 traecn / trae-cn / trae-china。%userprofile% 就是主目录，两平台在「主目录下的 .trae-cn/skills」这点上同构，不需要 dirWin。

为什么单独成一条而不是挂到 Trae 上：挂上去，国际版用户跑 --global --tool trae 就会装进一个 TRAE 根本不扫的目录 —— 正是这个 issue 想避免的事。项目级两版同构，仍由 --tool trae 一条覆盖。

🐛 拒绝文案说了假话 ​

全局-only 工具的项目级拒绝此前是一段写死的通用文案，内容是 ZCode 的情况（「项目级导入是应用内 UI 动作、不暴露磁盘路径」）。这对 TRAE CN 是假的 —— 它的项目级路径文档写得清清楚楚。

改成按工具可覆盖，TRAE CN 现在说的是真实原因：

❌ TRAE CN 不支持项目级安装。

  TRAE CN 的项目级技能目录与国际版 TRAE 相同（.trae/skills/），
  已经由 Trae 这一条覆盖，请直接用：
    npx superpowers-zh --tool trae
  本条目只用于 TRAE CN 独有的**全局**目录（~/.trae-cn/skills）。

🧮 工具数仍是 26，不是 27 ​

TRAE CN 在安装器里占一条，但它是同一个 IDE 的国内发行版，单独成条只为承载独有的全局路径。计进产品数就是灌水，站点工具墙还会出现两张同名 Trae 卡片让人不知道点哪个。

新增 editionOf 标记，audit 的计数口径把这类条目排掉 —— 这是 Copilot CLI 那条例外（共用 .claude/skills 但单独计数）的镜像另一半。

🛡️ 门禁自己的两个 bug ​

问题后果
verify-release J 节用 $( ) 取全局-only 工具名含空格的「TRAE CN」被词分割成 trae + cn 两个不存在的目标，门禁自己造了两条假失败
外链验活不带 User-Agentdocs.trae.cn 对默认 curl UA 一律 400、带浏览器 UA 返回 200，新文档的引用被误判成死链

加 UA 不是放宽判活口径：400 仍算死链，只是不再因为「对方不接待 curl」而误判。往文档里塞一条 reasonix.io 的真 404 做负向测试，照样被抓。

另外补了一条 dot 流程图门禁：graphviz 遇到「边引用了未声明的节点」不报错、只会静默新建一个孤儿框。同步上游 v6.3.0 时改了 SDD 流程图的节点文案，正是这个场景。

audit 163 pass / 0 warn，verify-release 163 → 164 pass。