要让skill精准触发,需在skill.md顶部yaml区块中用description明确触发场景(如“.tsx文件+‘组件性能优化’关键词”),name须全小写短横线格式;正文中用“## 触发条件”限定文件类型、上下文和排除项;通过放入项目专属路径(如.trae/skills/performance-checker/)实现物理隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让某个Skill只在特定代码文件类型、特定目录结构或特定用户指令关键词出现时才触发,而不是一问就跑——这需要设置精准的约束条件,否则AI可能在不该响应的时候强行介入,打断你当前的工作流。
用YAML元数据定义触发边界
打开你的SKILL.md文件,在最顶部用---包裹的YAML区块里,【description字段必须写明触发场景,不能只写功能】。比如写“当用户提交.tsx文件并提及‘组件性能优化’时触发”,AI才会在看到.tsx代码块+该关键词组合时调用此Skill;如果只写“用于优化React组件性能”,AI可能在你聊天气时也跳出来分析JSX。
name字段必须全小写+短横线,如performance-tsx-optimizer,含空格或大写字母会导致Skill加载失败。
在Markdown正文中嵌入动态约束逻辑
在YAML下方的正文里,用## 触发条件(When to Use)章节明确限定范围:
• 限定文件类型:仅当用户提供代码片段且文件扩展名为.tsx或.jsx时执行
• 限定上下文:必须同时满足两个条件——用户消息中包含“卡顿”或“渲染慢”,且当前项目根目录下存在vite.config.ts文件
• 排除干扰项:若用户消息含“忽略检测”“跳过审查”等关键词,立即终止执行
通过项目级路径实现物理隔离
把Skill文件夹放进项目专属路径,就能天然限制生效范围:
第一步:在你的项目根目录下创建.trae/skills/performance-checker/文件夹
第二步:将SKILL.md放入该文件夹
第三步:确保该Skill的YAML中name与文件夹名一致(小写+短横线)
这样它就只对这个项目的对话生效,其他项目打开TRAE时根本看不到它——不用手动开关,物理隔离最可靠。











