Trae Skill不生效的首要原因是文件未被识别，需检查路径是否为“.trae/skills/技能名/SKILL.md”、文件名是否严格大写、frontmatter格式是否正确，并确认启用状态、重启应用及路径归属（项目级或全局）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Trae Skill创建后不生效，最常见的情况是AI完全没反应——你输入触发词，它像没看见这个技能一样继续闲聊。这90%不是写得不好，而是文件根本没被Trae识别到。
第一层排查：文件是否被正确加载
打开你的项目根目录，确认是否存在 【.trae/skills/你的技能名/SKILL.md】 这一完整路径。注意：.trae 是隐藏文件夹，Windows 资源管理器需开启“显示隐藏的项目”；Mac Finder 按 Cmd+Shift+. 才能显示。
检查 SKILL.md 文件名是否全大写、无空格、无扩展名错误（比如写成 skill.md 或 SKILL.MD）。Trae 仅识别严格命名为 【SKILL.md】 的文件，其他任何变体均无效。
用文本编辑器打开 SKILL.md，确认文件开头和结尾有且仅有两组三个短横线 ---，且 frontmatter 中 name 和 description 字段后都带空格，例如：
---
name: api-checker
description: 检查 REST API 是否符合团队规范
---
第二层排查：触发逻辑是否被识别
方法一：直接喊名字测试
在 Trae CN 对话框中，输入你定义的技能名称（如“api-checker”）或完整描述中的关键词（如“审查 API”），不加任何额外说明。若此时仍无反应，说明问题仍在第一层。
方法二：检查 description 是否具备语义锚点
AI 不靠精确匹配触发，而是靠 description 中的自然语言意图建模。避免写“用于检查接口”，改写为“当用户说‘帮我看看这个 API 合不合规范’‘需要评审接口设计’‘检查下这个 endpoint’时使用”。越贴近真实对话句式，触发率越高。
注意：description 字段必须写在 frontmatter 区域内，不能放在正文里。写在正文里的描述对触发毫无作用。
第三层排查：启用状态与环境刷新
第一步：确认技能开关已打开
进入 Trae CN → 左下角⚙️设置 → 「规则和技能」→ 找到你的技能 → 检查右侧启用开关是否为蓝色（开启状态）。灰色即未启用，点击切换。
第二步：强制重载技能索引
完全退出 Trae CN（macOS 右键 Dock 图标选「退出」，Windows 在任务管理器中结束所有 traecn.exe 进程），再重新启动。Trae 仅在启动时扫描 .trae/skills/ 目录，运行中新增或修改文件不会自动热加载。
第三步：区分项目级与全局路径
如果你本意是做项目级技能，却把文件放到了 %USERPROFILE%\.traecli\skills\ 下，那它只会在全局生效，当前项目反而看不到。反之亦然。请严格对照路径规范选择存放位置。
