必须通过真实交互验证Skill行为：先确认启用及路径正确（项目级Skill须位于/.trae/skills/your-skill-name/SKILL.md），重启客户端刷新缓存；用最小触发词或/skill命令测试激活；分步观察执行过程，检查编码、步骤格式与逻辑；最后用Builder模式重放全流程定位问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你写完一个 Skill 的 SKILL.md 文件，却不确定它能不能按预期触发、执行或输出正确结果时，必须通过真实交互来验证它的行为是否符合设计目标。
先确认 Skill 已启用且路径正确
打开 Trae 设置 → 规则与技能 → 查看列表中你的 Skill 名称右侧开关是否为开启状态。若显示“已禁用”，点击开启；若根本没出现，说明文件未放在正确路径下。
【项目级 Skill 必须严格位于项目根目录/.trae/skills/your-skill-name/SKILL.md】，少一个点、多一层嵌套、文件名不是全大写 SKILL.md，Trae 都不会识别。
改完路径后，必须完全退出 Trae 桌面客户端再重新启动，否则缓存不刷新，新增 Skill 仍不可见。
用最小触发词测试是否能激活
方法一：直接输入你在 SKILL.md frontmatter 或触发条件里写的关键词，比如“帮我写周报”“审查 API”“生成测试用例”。只要匹配上 description 或 # 触发条件 中的任意一句，Skill 就应自动加载。
方法二：在对话框开头手动加前缀调用，格式为 /skill your-skill-name（your-skill-name 是你文件夹名，区分大小写），这是绕过意图匹配的强制触发方式，适合调试阶段快速验证逻辑是否跑通。
如果输入后 AI 仍按普通模式回复，没有执行你定义的步骤，说明触发词未命中，或 frontmatter 中的 name 字段与文件夹名不一致——这是最常被忽略的错误点。
分步观察执行过程
第一步：输入触发词后，观察 AI 是否立即返回你设定的首条响应（如“✅ 正在分析需求文档…”）。如果不是，说明 SKILL.md 中的执行步骤未被读取，检查文件编码是否为 UTF-8 无 BOM 格式。
第二步：若首条响应正常，但后续步骤缺失或顺序错乱，打开 SKILL.md，确认所有步骤是否用数字序号（1. / 2. / 3.）或明确换行分隔。Trae 不解析 Markdown 列表符号（- 或 *），只认带编号的纯文本步骤。
第三步：若步骤执行了但结果不符合预期，把 AI 当前输出内容复制出来，粘贴到新对话中问：“你刚才是根据哪个 Skill 的哪条指令生成这段内容的？”AI 会反向指出它引用了 SKILL.md 的第几行，帮你定位逻辑断点。
用 Builder 模式重放整个流程
切换到 Builder 模式 → 点击左上角“+ 新建任务” → 选择“使用 Skill” → 在弹出菜单中选中你的 Skill 名称 → 输入原始需求文本（不要加工、不要缩写）→ 点击运行。
Builder 会完整展示 Skill 加载、上下文注入、步骤执行、中间产物生成的全过程，比普通对话更透明。如果某一步卡住或跳过，说明该步骤依赖的输入字段在当前上下文中为空，需在 SKILL.md 中补全 fallback 提示，例如：“若未提供接口地址，请主动询问用户。”
