完成一个 Skill 的 SKILL.md 文件编写后，如何确认它能否正常工作？与其猜测，不如通过实际交互来验证其触发、执行与输出结果是否符合预期。以下是一套经过多次实战调试总结出的有效方法，每一步都曾遭遇问题，值得你参考借鉴。

确认 Skill 已启用且路径配置正确

打开 Trae 设置 → 规则与技能，检查列表中你的 Skill 名称右侧开关是否已开启。若显示“已禁用”，点击开启；若未出现，则说明文件放置位置有误。项目级 Skill 必须严格位于项目根目录/.trae/skills/your-skill-name/SKILL.md——少一个点、多一层嵌套，或文件名不是全大写 SKILL.md，Trae 均无法识别。

路径修改后，务必完全退出 Trae 桌面客户端并重新启动，否则缓存未刷新，新添加的 Skill 仍不可见。这一步看似简单，却最容易被忽略而卡住。

使用最小触发词测试 Skill 激活

验证激活情况有两种方法：

方法一：直接输入你在 SKILL.md frontmatter 或触发条件中设置的关键词，例如“帮我写周报”“审查 API”“生成测试用例”。只要匹配到 description 或 # 触发条件 中的任意一句，Skill 应自动加载。

方法二：在对话框开头手动添加前缀调用，格式为 /skill your-skill-name（your-skill-name 为文件夹名，区分大小写）。这是绕过意图匹配的强制触发方式，适合在调试阶段快速验证逻辑是否正常运行。

如果输入后 AI 仍按普通模式回复，未执行你定义的步骤，说明触发词未命中，或 frontmatter 中的 name 字段与文件夹名不一致——这是最容易被忽略的错误点，请仔细检查。

逐步观察 Skill 执行过程

第一步：输入触发词后，观察 AI 是否立即返回你设定的首条响应（例如“✅ 正在分析需求文档…”）。若没有，说明 SKILL.md 中的执行步骤未被读取，请检查文件编码是否为 UTF-8 无 BOM 格式。

第二步：如果首条响应正常，但后续步骤缺失或顺序错乱，请打开 SKILL.md，确认所有步骤是否使用数字序号（1. / 2. / 3.）或明确换行分隔。Trae 不解析 Markdown 列表符号（- 或 *），仅识别带编号的纯文本步骤。

第三步：如果步骤已执行但结果不符合预期，将 AI 当前输出内容复制出来，粘贴到新对话中询问：“你刚才是根据哪个 Skill 的哪条指令生成这段内容的？”AI 会反向指出它引用了 SKILL.md 的第几行，帮助你定位逻辑断点。这种反向追问技巧比逐行排查高效得多。

使用 Builder 模式重放 Skill 完整流程

切换到 Builder 模式 → 点击左上角“+ 新建任务” → 选择“使用 Skill” → 在弹出菜单中选中你的 Skill 名称 → 输入原始需求文本（不要加工、不要缩写）→ 点击运行。

Builder 模式会完整展示 Skill 加载、上下文注入、步骤执行、中间产物生成的全过程，比普通对话更透明。如果某一步卡住或跳过，说明该步骤依赖的输入字段在当前上下文中为空，需要在 SKILL.md 中补充 fallback 提示，例如：“若未提供接口地址，请主动询问用户。”这样既能保证流程完整，也能提升用户体验。