在Trae中从零创建可用Skill需同时满足文件结构、命名规范、内容格式和IDE加载路径四条件；须确认版本≥3.3.21、建立.trae/skills/目录、按规范命名文件夹与SKILL.md、严格书写YAML元数据及Markdown主体，并通过重启IDE或热刷新验证启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Trae中从零创建一个可用的Skill，需要同时满足文件结构、命名规范、内容格式和IDE加载路径四个硬性条件，缺一不可。手动建错一个层级或写错一个文件名，Skill就不会出现在技能列表里，AI也完全无法识别。
准备环境与确认前提
打开Trae IDE，点击左下角齿轮图标→「关于」，确认版本号 ≥ 【3.3.21】。低于此版本不支持Skills功能，所有后续操作无效。
检查项目根目录是否存在隐藏文件夹 .trae。若不存在，需手动创建；若存在但无 skills 子目录，则在此目录下新建 skills 文件夹。
建立标准目录结构
在 .trae/skills/ 下新建一个文件夹，命名为全小写+连字符形式，例如 api-reviewer。
进入该文件夹，新建一个纯文本文件，严格命名为 【SKILL.md】（必须全大写、无空格、无扩展名错误）。
这个文件夹就是Skill的唯一合法根目录——不能放在 src 里，不能放在 docs 里，也不能用 skill 或 skill-api-reviewer 这类非规范名。
编写SKILL.md核心内容
用任意编辑器打开 SKILL.md，按以下三段式结构书写：
第一部分：YAML 元数据块（必须顶格，前后用---包裹）：
---
name: api-reviewer
description: 检查 TypeScript 接口定义是否符合团队 REST 规范。当用户提到“审查接口”“看下这个 API 合不合规范”时自动启用。
license: MIT
metadata:
version: "1.0.0"
---
第二部分：Markdown 主体（空一行后开始）：
# 角色
你是一位专注 API 设计的架构师，熟悉 OpenAPI 3.0 和团队内部接口命名约定。
# 工作流程
1. 先提取用户提供的接口代码片段或 URL 路径
2. 检查 HTTP 方法是否全小写、路径是否含冗余斜杠、参数是否使用 snake_case
3. 输出带 ✅/❌ 标记的逐条反馈，并附修改建议
# 示例
**用户输入**：`GET /v1/users/{id}/orders?status=active`
**AI 输出**：✅ 方法正确｜❌ 路径应为 `/v1/users/{id}/orders`（去除查询参数）｜✅ 参数命名合规
注意：YAML 块里的 name 必须与外层文件夹名完全一致，大小写、连字符都不能差——这是Trae匹配Skill的唯一依据。
让Trae识别并启用Skill
方法一：重启IDE
关闭Trae → 重新打开 → 点击设置 → 「规则和技能」→ 查看「项目技能」标签页，你的 api-reviewer 应已列出并默认启用。
方法二：热刷新
在Trae中任意打开一个 .ts 文件 → 在对话框输入：“请使用 api-reviewer 技能检查这段代码”，若AI开始按你写的流程执行，说明加载成功。
方法三：手动开关
在技能管理页找到该技能右侧的开关按钮，点击切换状态。关闭后AI将彻底忽略该Skill，即使指令完全匹配也不会触发。
