From 1a388c685165cf9451ae280d70a8a9b5e794cc64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?AI=E4=B8=8D=E6=AD=A2=E8=AF=AD?=
 <12096460+jnMetaCode@users.noreply.github.com>
Date: Tue, 2 Jun 2026 20:51:04 +0800
Subject: [PATCH] =?UTF-8?q?docs(trae):=20=E4=BF=AE=E6=AD=A3=E6=89=8B?=
 =?UTF-8?q?=E5=8A=A8=E5=AE=89=E8=A3=85=E8=B7=AF=E5=BE=84=20.trae/rules=20?=
 =?UTF-8?q?=E2=86=92=20.trae/skills?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

安装器实际把各 skill 复制到 .trae/skills/，并在
.trae/rules/superpowers-zh.md 生成 bootstrap 规则。旧文档让用户把
skills 往 .trae/rules/ 拷，会误导。对齐安装器真实行为，并注明手动复制
不会生成自动触发规则。
---
 docs/README.trae.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/README.trae.md b/docs/README.trae.md
index 2bb8cb7..f08582a 100644
--- a/docs/README.trae.md
+++ b/docs/README.trae.md
@@ -9,16 +9,18 @@ cd /your/project
 npx superpowers-zh
 ```
 
-安装脚本会自动检测 `.trae/` 目录并将 skills 复制到 `.trae/rules/`。
+安装脚本会自动检测 `.trae/` 目录，将各 skill 完整复制到 `.trae/skills/`（含 `SKILL.md` 及其 `scripts/` 等附属文件），并在 `.trae/rules/superpowers-zh.md` 生成一份 bootstrap 规则用于自动触发。
 
 ## 手动安装
 
 ```bash
 git clone https://github.com/jnMetaCode/superpowers-zh.git
-mkdir -p /your/project/.trae/rules
-cp -r superpowers-zh/skills/* /your/project/.trae/rules/
+mkdir -p /your/project/.trae/skills
+cp -r superpowers-zh/skills/* /your/project/.trae/skills/
 ```
 
+> 手动复制只会放好 skill 文件，不会生成 `.trae/rules/` 下的 bootstrap 自动触发规则。建议优先用上面的 `npx superpowers-zh`，否则需要在对话里手动点名 skill 才会激活。
+
 ## 工作原理
 
 Trae 使用 `.rules` 机制管理 AI 行为：
@@ -32,7 +34,7 @@ Trae 使用 `.rules` 机制管理 AI 行为：
 
 ### Skills 适配
 
-superpowers-zh 的 SKILL.md 文件可以直接作为 Trae 的 rules 使用。Trae 会在初始化时加载 `.trae/rules/` 下的所有规则文件。
+安装器把各 skill 放在 `.trae/skills/<skill-name>/`，并在 `.trae/rules/superpowers-zh.md` 写入一份 bootstrap 规则。Trae 初始化时加载 `.trae/rules/` 下的规则，bootstrap 规则会引导 AI 在任务匹配时读取对应的 `.trae/skills/<skill-name>/SKILL.md` 并遵循其流程。
 
 ### 推荐配置