Skills 是什么？从基本原理到安装第一个技能

Skills（技能）是供 AI 智能体使用的可复用任务说明包：把某类任务的做法、参考材料和可选脚本放在一起，让支持它的工具在需要时读取。它不是重新训练模型，也不是装上之后 AI 就能完成任何事情。

如果你经常重复交代同一套要求，例如“先整理素材，再写摘要，最后列出待确认事项”，就可以考虑把这套做法整理成 Skill。以下从一个简单的笔记任务出发，再以 TRAE 的安装方式说明怎样开始。

一句话理解：给 AI 一份可复用的操作说明

普通提示词通常说明这一次要做什么；Skill 则保存一类任务反复使用的规则。两者不是对立关系：技能被加载后，你仍需提供本次材料、目标和限制。

可以把它比作工作手册，但手册不是员工，更不是执行许可。实际做事的是智能体及其可用工具；能否读取文件、联网或转换文档，还取决于产品能力、环境和你的授权。

例如，一个“整理学习笔记”技能规定：保留原意，提炼三条要点，未知信息单独列出。下次你只需提供新笔记，不必重新解释全部格式。这个例子用于说明思路，不是效果测试或保证。

一个技能包里有什么

核心文件叫 SKILL.md，是一份 Markdown 格式的说明文档。开头的 YAML 元数据用来说明技能名称和适用场景，后面的正文写具体步骤与边界。下面是常见结构，并非每个文件夹都必须存在：

study-notes/
  SKILL.md       必需：名称、适用场景、操作说明
  scripts/       可选：重复处理任务的脚本
  references/    可选：需要时查阅的资料
  assets/        可选：模板或其他素材

最简单的技能只有一个 SKILL.md。不要为了看起来完整，创建一堆空目录。涉及脚本时，还要检查运行环境和依赖；把转换脚本放进文件夹，并不意味着电脑已经安装了它需要的软件。

它什么时候被调用

常见机制是先让智能体知道技能的名称和描述；遇到相关任务时，再读取完整说明，按需要读取其他资料。这种“渐进式加载”可以减少无关内容占用上下文，而不是启动时把所有技能全文塞进去。

识别通常依赖任务与描述是否相关，不只是机械匹配某个关键词。你也可以明确要求“使用 study-notes 技能整理以下笔记”。具体触发方式由宿主产品决定，自动匹配不代表每次都会触发。

Skill、工具和 MCP 也不是一回事。技能描述怎样做；工具提供实际操作能力；MCP 是连接外部工具与资源的一种协议。写了“调用 ComfyUI”不会自动部署 ComfyUI，也不会自动获得服务凭证。

先选安装范围，再导入

本节依据 2026 年 9 月 21 日核对的 TRAE 中文 TraeCode 文档。其他产品、发行版的入口和目录可能不同，不要直接照搬路径。

在该产品的“设置 → 技能与命令”中，找到技能区域，点击“创建”，选择全局或项目范围。可以导入 SKILL.md，也可以导入包含说明及依赖文件的 ZIP 包；检查名称、描述和指令后再确认。

项目技能只用于当前项目，适合项目专用规范；全局技能供不同项目复用，适合通用笔记整理。第一次练习建议选择项目范围，便于检查和移除，不影响其他项目。

如需核对手动放置位置，该文档列出的项目目录是 .trae/skills/；中文产品的全局目录在 macOS/Linux 为 ~/.trae-cn/skills，在 Windows 为 %userprofile%/.trae-cn/skills。每个技能单独占一个子目录，里面放 SKILL.md。

安装后检查技能是否已启用。找不到时，先确认产品版本、范围和目录层级，避免解压后多套一层文件夹；不要把 AI 猜出的路径当成官方配置。界面与本文不同时，以文末对应产品文档为准。

小练习：安装一个不需要脚本的笔记技能

先准备一个练习项目，将下面内容保存为 study-notes 文件夹中的 SKILL.md，再按上节导入项目范围。它只整理你粘贴的文字，不要求联网、付费或配置开发环境。

---
name: study-notes
description: 当用户需要整理学习笔记、提炼要点并列出疑问时使用。
---
# 学习笔记整理
先阅读用户提供的笔记；没有材料时请用户补充。
只依据原文，输出“要点”“待确认”“下一步”三部分。
要点最多三条，保留未完成和不确定的状态。
不要添加原文没有的事实，不需要访问网络或运行命令。

名称采用小写字母与连字符，并与文件夹名称保持一致。description 是适用场景描述，不要只写“很好用的助手”；让智能体知道什么时候该使用，比写宣传语更重要。

启用后，用以下虚构材料测试：

请使用 study-notes 技能整理以下学习笔记。
这是练习材料：今天认识了 Skills 的基本结构；还没有试过安装；
不确定项目技能能否在其他项目中使用；下一步准备检查产品文档。
请只整理这些信息，不要联网、执行命令或修改文件。

检查结果是否有规定的三部分，是否把“尚未安装”错写成“已经完成”。再换一段材料，观察格式是否仍然一致。若产品提供技能调用记录，一并查看；仅凭回答风格相似，不能断定技能已经加载。

安装前后，守住这几条边界

技能包可能包含可执行代码，应像安装软件一样检查来源。先读说明，再看脚本是否访问无关文件、上传数据或下载其他程序。不理解的命令先不要执行，也不要为了运行一个技能随意开放整个电脑的权限。

用虚构材料或文件副本试用，保留原文件。涉及合同、客户信息、账号密钥时，先考虑隐私与授权；给技能写上“律师”或“专家”不会赋予专业资格，更不能替代专业审查。

最后记住：安装成功、被正确调用、输出符合要求，是三件不同的事。先用一个小任务逐项验证，再扩展到复杂流程。发现不符合预期时，可以先停用技能，检查说明和依赖，而不是继续放大它的权限。