Superpowers 中文版 — TRAE CN（国内版）安装指南

TRAE 分国际版（trae.ai）与国内版 TRAE CN（trae.cn）。两版的项目级技能目录相同，全局目录不同 —— 这份文档讲的是差异部分。

一句话

想要什么	命令	装到哪
项目级（两版通用）	npx superpowers-zh --tool trae	.trae/skills/
全局（仅国内版）	npx superpowers-zh --global --tool traecn	~/.trae-cn/skills/

为什么全局要单独一条命令

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

全局技能：macOS/Linux ~/.trae-cn/skills，Windows %userprofile%/.trae-cn/skills

项目技能：项目所在路径下的 .trae/skills/ 目录

注意全局目录是 .trae-cn，不是 .trae —— 差这一个后缀，装进去 TRAE 就永远不会扫到。

而国际版文档没有给出全局技能的磁盘路径。按本项目一贯口径：没有一手出处就不猜路径，所以国际版不提供全局安装，请用项目级。

（%userprofile% 就是用户主目录，所以 Windows 与 macOS/Linux 在「主目录下的 .trae-cn/skills」这一点上是同构的，安装器不需要为它单独处理平台差异。）

项目级为什么两版共用一条命令

两版的项目级路径都是 .trae/skills/，所以 --tool trae 一条覆盖两版。

如果你对 TRAE CN 用项目级安装，安装器会明确拒绝并告诉你该用哪条命令，而不是装到一个可能不生效的地方：

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

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

自动触发

• 项目级安装会同时写 .trae/rules/superpowers-zh.md，skill 因此能自动触发。
• 全局安装只放 skill 文件，不写规则文件 —— TRAE CN 文档没有给出全局规则文件的确切路径，不确认就不写。所以全局装完需要在对话里显式点名 skill，或者改用项目级安装。

卸载

npx superpowers-zh --global --uninstall --tool traecn   # 清 ~/.trae-cn/skills
npx superpowers-zh --uninstall --tool trae              # 清 .trae/skills + .trae/rules

别名

traecn、trae-cn、trae-china 三个都指向同一个目标。

来源

• TRAE CN 技能文档 · docs.trae.cn/ide/skills —— 全局与项目级路径（核对日期 2026-09-08）
• TRAE 国际版技能文档 · docs.trae.ai/ide/skills —— 只给出 .trae/skills/，无全局路径

相关 issue：#35 建议支持 Trae CN