要让trae准确识别并调用skill,必须精准优化name和description:name须为纯英文短词组合(如code-standards),description需含3~5个用户真实提问动词+名词组合(如“检查驼峰命名”),修改后须重启trae生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Trae准确识别并调用你定义的Skill,必须让AI在毫秒级响应中从数百个潜在技能里锁定目标,这依赖name和description是否精准匹配用户自然语言表达,而非靠运气或反复提示。
优化Skill元数据:name与description必须可检索
打开你的Skill文件夹下的SKILL.md文件,在顶部YAML区块中检查name和description字段。
name只能是纯英文短词组合,不带空格、符号或大小写混用,例如code-standards、test-requirement-analyst;若写成“Code Standards”或code_standards,Trae将无法解析该Skill。
description必须包含3~5个用户真实提问时会使用的动词+名词组合,比如“分析需求文档→拆解测试点→生成结构化用例”,而不是“本技能用于提升测试质量”。【AI只匹配字面关键词,不理解语义】
改完保存后,重启Trae——只有重启才能刷新元数据索引,热重载不生效。
验证触发路径:用AI自己测是否能发现你的Skill
在Trae对话框中输入:“帮我找一个能自动检查TypeScript命名规范的Skill。”
如果返回结果里没有你的skill-reviewer,说明name或description仍不达标。此时不要修改代码逻辑,只调整SKILL.md顶部的元数据。
方法一:把用户可能说的口语化表达直接塞进description,例如加入“驼峰命名”“PascalCase组件名”“snake_case字段”等具体术语,这些是工程师日常搜索的真实词汇。
方法二:在name中嵌入强特征词,比如把ui-validator改成vue-pascalcase-validator,哪怕多两个字符,命中率也能从40%跃升至85%以上。
排除干扰项:清理无效Skill和重复注册
第一步:进入项目根目录 → 查看.trae/skills/下是否存在多个功能重叠的Skill文件夹,例如既有code-standards又有ts-linter又有naming-checker。
第二步:逐个打开它们的SKILL.md,比对description是否都写了“检查变量命名”,若是,则保留最完整、name最精准的那个,其余全部删除。
第三步:打开Trae设置 → 技能管理页面 → 检查是否有同一Skill被同时注册为“项目级”和“全局级”,【重复注册会导致元数据冲突,AI随机失效】,只保留一种作用域。
做完这三步后,在对话框输入原测试指令,观察是否立即出现“调用skills”提示。











