必须使用3.3.21及以上版本trae,创建.trae/skills/{skill-name}/skill.md结构,其中skill.md需含name、description、instructions三要素且yaml头部顶格。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Trae中成功创建一个可被AI识别并调用的Skill,必须提前准备好符合规范的文件结构和核心定义内容,缺一不可。
确认Trae版本是否支持Skill功能
打开Trae IDE,点击左下角「帮助」→「关于」,查看当前版本号。只有 【3.3.21 及以上版本】 才原生支持Skills功能。低于此版本会找不到「规则与技能」入口,也无法解析SKILL.md文件。
若版本过低,请前往官网下载最新安装包覆盖升级——旧版强行复制文件夹也不会生效。
准备SKILL.md文件
这是Skill的唯一强制性文件,必须严格命名为全大写的 【SKILL.md】,不能写成skill.md、Skill.md或README.md。
文件内容至少需包含三部分:名称(name)、描述(description)、指令(instructions)。例如:
name: 代码审查员description: 检查TypeScript代码是否符合团队规范,包括命名、缩进、JSDoc覆盖率
instructions: 请逐行扫描用户提供的代码,指出不符合规范的具体位置,并给出修改建议,最后输出一份带编号的整改清单
注意:YAML格式的头部必须顶格写,前面不能有空格或注释;正文指令要用自然语言,避免AI无法理解的缩写或内部代号。
构建标准目录结构
第一步:在你的项目根目录下,新建一个隐藏文件夹 【.trae】(注意开头是英文点号)。
第二步:进入 .trae 文件夹,新建子文件夹 【skills】。
第三步:在 skills 文件夹内,新建你自己的技能文件夹,例如 code-reviewer 或 api-doc-generator。
第四步:把写好的 SKILL.md 文件放入该技能文件夹中。最终路径必须是:
/your-project/.trae/skills/code-reviewer/SKILL.md
这一步路径错一级,比如把SKILL.md直接放在.skills/下而没进子文件夹,Trae就完全识别不到这个Skill。
可选但强烈建议准备的配套文件
方法一:添加 README.md
用于说明该Skill适用场景、输入样例、已知限制,方便团队成员快速上手。
方法二:添加 main.py 或 script.js
当Skill需要执行真实操作(如调用API、生成文件)时,这个脚本会被Trae自动触发。注意脚本必须导出默认函数,且参数签名要与SKILL.md中声明的inputs字段一致。
方法三:放入模板文件(如 template.tsx)
如果Skill常用于生成特定结构代码,把标准模板放进去,AI可在生成时自动参考并填充变量。










