<p>要让Trae Skill自动触发,需在SKILL.md中精准设置When to use:在YAML元数据description里写明触发动词和典型上下文,并推荐添加## When to use区块,每行用“-”列出具体可感知的触发信号,修改后必须重启Trae才能生效。</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Trae Skill在特定需求出现时自动触发,而不是每次都要手动喊“用这个技能”,关键在于精准设置它的使用场景(When to use)。这一步直接决定AI能不能在你写PR、提Bug、改接口时,主动调出对应Skill,而不是等你想起它来再点开。
在SKILL.md里声明触发条件
打开你的Skill文件夹,编辑SKILL.md顶部的YAML元数据区块。
在description字段中,【必须包含明确的触发动词和典型上下文】,比如“当用户说‘检查API规范’‘评审接口设计’或提交OpenAPI YAML文件时使用”。AI只认自然语言描述,不识别正则或代码逻辑。
不要写“用于API审查”,这种泛泛而谈的描述会让AI无法判断何时该调用。它需要知道你在什么动作、什么输入、什么对话片段下会需要它。
补充When to use专用区块(推荐)
在YAML元数据下方、正文指令上方,插入一个独立的## When to use二级标题区块。
每行写一条具体、可感知的触发信号,用短横线(-)开头:
- 用户粘贴了swagger.yaml或openapi.json文件内容
- 对话中出现“这个接口要不要加版本号”“字段命名是否规范”等疑问
- 提交的Git diff里包含/api/路径下的文件变更
这一区块会被AI优先扫描,比description更结构化、更易匹配。漏掉它,Skill可能只在你直呼其名时才响应。
验证触发是否生效
方法一:重启Trae后,在AI对话框输入一句符合你设定场景的话,例如:“我刚改了user-service的/v1/users接口,帮我看下命名合不合规范”。如果左下角出现“正在调用api-style-guide Skill…”提示,说明触发成功。
方法二:在Trae设置→规则和技能→找到你的Skill,点击右侧“测试触发”按钮,系统会模拟5条典型用户语句,逐条显示是否命中。
【注意:修改SKILL.md后必须重启Trae,否则新触发条件不会加载】


















