必须直接编辑skill.md文件才能生效,项目级修改路径为.trae/skills/技能文件夹名/,全局修改需重启trae且路径因系统而异;description字段是ai调用skill的唯一依据,修改后须验证触发提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Trae Skill创建后需要调整触发逻辑、更新指令规则或修复输出格式错误,必须直接编辑核心文件SKILL.md才能生效,改完不重启编辑器就看不到变化。
修改项目级Skill的SKILL.md文件
打开你的项目根目录 → 进入.trae/skills/技能文件夹名/ → 用任意文本编辑器打开SKILL.md文件。
直接修改YAML头部的description字段,这是AI判断是否调用该Skill的唯一依据。比如原描述是“检查JavaScript代码规范”,现在要支持TypeScript,就得改成“检查JavaScript和TypeScript代码规范”。
正文部分可增删步骤、替换示例、调整语气风格。注意:所有修改必须保存后才生效,Trae不会自动热重载SKILL.md内容。
修改全局Skill的SKILL.md文件
Mac/Linux用户前往~/.traecli/skills/技能文件夹名/SKILL.md;Windows用户打开%USERPROFILE%\.traecli\skills\技能文件夹名\SKILL.md。
【改完必须重启Trae】,否则全局Skill仍加载旧版本缓存,新指令完全不生效。
全局Skill修改风险更高——它会影响所有项目。建议先在单个项目里验证修改效果,再同步到全局路径。
修改后验证是否生效
第一步:清空对话历史,新开一个对话窗口。
第二步:输入明确触发描述,例如你刚把description改成“生成符合团队规范的Vue3组件”,那就直接说“帮我写一个Vue3组件”。
第三步:观察AI回复开头是否出现“正在调用skills: your-skill-name”字样。没有这行提示,说明修改失败或description匹配度不够。
如果AI仍按旧逻辑执行,立刻检查SKILL.md顶部YAML块里的description是否拼写错误、标点遗漏或触发关键词被删掉——【YAML头部description字段缺失关键词,Skill将彻底无法被识别】。











