刚创建完 Trae Skill 后必须立即验证其响应逻辑，否则后续调用将失效；需确认技能已启用、用触发词测试响应、排查 frontmatter 格式、触发条件表述及缓存问题。

刚创建完一个 Trae Skill，你得立刻验证它能不能按预设逻辑响应指令，否则后续调用全是空转——别等正式用时才发现触发词没生效、步骤顺序错乱或输出格式跑偏。

确认 Skill 已启用并处于活跃状态

打开 Trae CN 桌面端 → 点击左下角齿轮图标进入「设置」→ 找到「规则与技能」→ 在技能列表中找到你刚创建的那条 → 【务必检查右侧开关是否为蓝色“已启用”状态】。如果显示灰色“已禁用”，点击开关手动开启；未启用的 Skill 不会参与任何意图匹配。

用触发词在对话框中直接测试

切换回主对话界面，输入任意一个你在 Skill 中定义的触发词（比如“生成测试用例”或“帮我分析需求”），然后回车发送。

若 Skill 正常工作，AI 会在几秒内按你设定的步骤逐条回复，且内容与 SKILL.md 中「执行步骤」完全一致；若无响应，说明触发词未被识别或 frontmatter 格式有误。

排查常见失败原因

方法一：检查 frontmatter 是否严格符合 YAML 规范

复制粘贴以下结构到你的 Skill 编辑区最顶部，确保前后都有独立一行的三个短横线，冒号后必须跟一个空格：

---

name: your-skill-name

description: 描述用途

version: 1.0.0

---

方法二：验证触发词是否被准确收录

在「规则与技能」页面，点击该 Skill 右侧「编辑」→ 查看「触发条件」区块里是否明确写了类似“当用户说‘测试 skill’或‘hello skill’时触发”这样的自然语言描述；【不要只写关键词，必须是完整句子形式】，否则 Trae 的意图匹配引擎无法捕获。

方法三：强制重启上下文

完全退出 Trae CN 进程（macOS：右键 Dock 图标→退出；Windows：任务管理器结束 traecn.exe）→ 重新打开软件 → 再次输入触发词测试。Trae 的元数据层有时缓存未刷新，冷启动能绕过这一问题。