Trae_Skill如何添加技能说明？

必须在项目根目录创建.trae/skills/your-skill-folder/SKILL.md文件，严格遵循角色、任务、输出要求三段式结构，文件名全大写且编码为UTF-8，重启Trae后出现“正在调用skills:...”即生效。

你想在Trae里让AI自动按团队规范检查代码、写文案或生成接口文档，但每次都要重复描述规则，既啰嗦又容易漏项——这时候必须给AI配一份“岗位说明书”，也就是Skill的技能说明文件SKILL.md。

确认项目根目录结构

打开你的项目文件夹，在最外层（不是src、不是node_modules，就是你用VS Code打开时左上角显示的那个文件夹名所在层）创建名为【.trae】的隐藏文件夹。Windows用户需手动输入完整名称，系统不会自动补全点号；macOS/Linux可直接在终端执行mkdir -p .trae/skills。

进入【.trae】文件夹，新建一个叫【skills】的子文件夹。这个路径必须严格是.trae/skills/，多一级少一级AI都识别不到。

新建技能文件夹并命名

在.trae/skills/下新建一个文件夹，名字要能一眼看出用途，比如code-reviewer、api-doc-generator或seo-title-writer。避免用中文、空格或特殊符号，否则部分系统会解析失败。

进到这个新文件夹里，右键→新建文本文件，重命名为SKILL.md——注意：必须全大写，必须是.md后缀，不能是skill.md、Skill.md或SKILL.txt。

写入技能说明内容

用任意文本编辑器打开SKILL.md，至少包含三块内容：

① 【# 角色】：定义AI身份，例如“你是一位专注前端性能优化的资深工程师，熟悉Lighthouse评分逻辑和现代打包策略”；

② 【# 任务】：明确触发场景，例如“当我提供一段React组件代码时，指出可能导致CLS偏高的写法，并给出改进建议”；

③ 【# 输出要求】：约束格式，例如“用表格列出问题行号、风险等级（高/中/低）、修复方案，最后附一句总结”。

不需要写“请”“谢谢”等礼貌用语，AI只认结构化指令；空行分隔不同区块，否则可能被误读为连续段落。

验证技能是否生效

保存SKILL.md后，重启Trae。在AI对话框输入“帮我检查这段代码的可访问性问题”，如果AI回复开头出现“正在调用skills: code-reviewer…”字样，说明技能已加载成功。

若无提示，检查.trae/skills/your-skill-folder/SKILL.md路径是否拼写正确，文件编码是否为UTF-8（不要用GBK），以及Trae版本是否≥3.3.21。