一、功能详解

什么是 Skill

技能（Skill）是给智能体使用的 “专业能力说明书”，由 SKILL.md 定义场景、规则和执行步骤。

智能体不会一开始就加载所有技能，而是在相关任务出现时按需加载，减少无关干扰，降低上下文消耗。

什么时候使用

当你遇到以下情况时，技能通常是一个很合适的选择：

• 高频重复：同一类任务你已经反复做过很多次，例如每次都要求 AI 按固定格式写周报、做代码审查或生成测试用例。
• 输出要稳定：你希望不同时间、不同任务里，AI 都按照统一标准输出，例如品牌规范、代码规范、设计规范。
• 流程比较固定：任务包含一套明确步骤，例如“先检查输入，再生成方案，再输出验收清单”。
• 经验需要共享：团队里有成熟 SOP、最佳实践或模板，希望让更多人直接复用。

技能 VS 其他功能

技能类型和运行环境

TRAE Work 中常见的技能可以按生效范围理解：

• 项目技能：在项目内创建，只在当前项目中生效，适合项目规范、项目流程、项目专属模板。
• 全局技能：在设置中心创建，可以在多个项目中使用，适合个人长期复用的方法、通用工作流或团队通用规范。

技能也会区分运行环境。

• 本地技能主要服务本地任务。
• 云端技能主要服务云端任务以及从 GitHub 拉取的项目。

创建或安装技能前，可以先确认你的任务是在本地还是云端运行。

二、技能安装方式

你可以通过两种方式开始使用技能。

方式一：从技能市场安装

1. 在左侧任务栏中点击顶部区域的“技能”，找到内置技能市场。

TRAE Work 的技能市场为不同使用场景提供了多种技能，涵盖数据分析、界面设计、开发工具等领域。你可以直接从中安装所需技能。

1. 在 技能市场 页签中，搜索所需技能，然后点击技能卡片右侧的 + 按钮，即可安装成功。

1. 安装完成后，技能会出现在“已安装”页签，并默认启用。

方式二：上传本地技能

1. 准备一个包含根级 SKILL.md 文件的 zip 或 .skill 文件。
2. 进入内置的技能市场，点击右上角“上传技能”。

1. 上传本地技能文件，点击确认。
2. TRAE Work 会解析并安装该技能，安装完成后默认启用。

三、如何写技能

自己写

一个技能中必须包含 SKILL.md 文件。复杂技能还可以包含示例、模板、脚本或参考资源。

skill-name/
├── SKILL.md               # 必需：智能体的核心指令
├── examples/              # 可选：输入 / 输出示例
│   ├── input.md
│   └── output.md
├── templates/             # 可选：可复用模板
│   └── component.tsx
└── resources/             # 可选：参考文件、脚本或素材
    └── style-guide.md

一个基础 SKILL.md 通常包含名称、描述、使用场景、执行指令和示例。

---
name: 技能名称
description: 简要描述这个技能的功能和使用场景
---

技能名称

描述
说明这个技能的作用。

使用场景
说明什么时候应该触发这个技能。

指令
清晰地告诉智能体应该按什么步骤完成任务。

示例（可选）
给出输入 / 输出示例，帮助智能体理解预期效果。

AI 帮你写

如果不会自己写 Skill，你也可以使用 AI 帮你写 Skill。

• 让AI根据你的项目和习惯，自动生成最适合你的Skill
• 重复的流程应该变成Skill —— 判断标准：反复给AI描述同一套步骤 → 它该变成Skill
• 技巧：直接在对话中和 AI 说，把我刚才写PRD文档的流程沉淀成一个 Skill，以后每次写 PRD 文档的时候都调用这个SKill。（暂时不支持远程 Remote 模式）

四、如何调用技能

技能可以手动调用，也可以由 AI 自动判断调用。

手动调用

• 在对话框中输入 /，从列表中选择需要的技能。
• 直接在指令里说明要使用哪个技能，例如：“用 codemap 技能总结这个分支的改动。”
• 在技能管理中心的“已安装”页签中打开技能详情，点击“运行技能”。

当任务比较关键、复杂，或者你明确知道要使用哪个技能时，推荐手动调用。

自动调用

当你的需求与某个技能的描述或使用场景高度匹配时，AI 可以自动加载并使用该技能。例如，一个代码审核技能的触发条件是“当用户请求代码反馈或评审时”，那么当你说“帮我 review 一下这个 PR”，AI 就可能自动调用该技能。

五、社区热门 Skills 推荐

如果你暂时不知道从哪里开始，可以先参考社区里已经沉淀较多的 Skills。它们不一定要直接照搬，更适合作为灵感来源：看看别人是如何定义场景、拆解流程、组织示例和约束边界的。

Claude 官方 Skills 仓库

• Claude 官方 Skills 仓库提供了很多高质量示例，适合学习 Skill 的结构、描述方式和任务边界设计。

Claude 官方 Skills 仓库

社区资源可以怎么用

• 想找现成案例：可以浏览 Awesome Claude Skills 这类社区集合。
• 想快速复用：可以从 Skills 市场或社区仓库中下载适合的 Skill，再按自己的任务修改。
• 想做业务定制：建议先复制一份社区 Skill，再改描述、触发场景、输出格式和示例。
• 想学习写法：重点看它的 description、目录结构、示例和“什么时候不该使用”的约束。

六、创建 & 迭代 Skill 的技巧

写 Skill 不建议一上来就追求“大而全”。更稳妥的方式，是先找到一个真实重复任务，再用评测和反馈逐步把 Skill 打磨稳定。

1. 先建立无 Skill 基线：不使用 Skill，直接让 AI 完成目标任务，观察它在哪些地方容易跑偏、不稳定或误解需求。
2. 再定义评测用例：围绕这些失败点，设计 3-5 个可复现的测试任务，并写清楚什么结果算通过、什么结果算失败。
3. 编写最小可用 Skill：先只写能解决核心问题的最短路径，明确什么时候应该使用、什么时候不应该使用。
4. 补充边界和示例：当最短路径稳定后，再补充输入输出格式、典型示例、反例和容易误用的场景。
5. 持续回归验证：每次修改 Skill 后，都用之前的评测用例重新跑一遍，确认新规则没有破坏旧效果。
6. 回到真实任务校准：在真实使用中继续观察误触发、漏触发、输出不稳定等问题，把它们变成新的评测用例。

七、猜你想问

Q1：技能和普通提示词最大的区别是什么？

A：提示词更适合一次性任务；技能更适合反复使用的任务。只要你发现某段提示词经常复用，就可以考虑把它沉淀成技能。

Q2：技能是不是越多越好？

A：不是。技能应该服务明确场景。过多、描述模糊或互相重叠的技能，可能会让 AI 更难判断该调用哪个。

Q3：为什么我写的 Skill 不生效，或者效果不符合预期？

A：优先检查 description 是否写清楚。AI 通常会先通过描述判断什么时候该用这个 Skill。如果描述太泛、太短或太专业，AI 就可能不会调用，或者在错误场景调用。

Q4：使用 Skill 的效果，会受到模型影响吗？

A：会。更强的模型通常更擅长理解意图、挑选合适 Skill、安排执行步骤；但 Skill 本身会决定具体任务的执行流程和稳定下限。模型负责“选得准”，Skill 负责“做得稳”。

Q5：技能会不会一直占用上下文？

A：不会。技能采用按需加载机制，通常只有在任务相关时才会加载详细内容，这也是它相比规则更适合具体工作流的原因之一。

Q6：Skills 是不是万能的？

A：不是。Skills 更适合流程明确、边界清晰、可以反复执行的任务。高度开放的创意任务、实时动态决策、单纯知识问答或闲聊，不一定适合用 Skill。

Q7：我应该创建项目技能还是全局技能？

A：只服务当前项目的流程、规范和模板，适合做项目技能；跨项目都会用到的个人方法或团队通用规范，更适合做全局技能。

Q8：看到一个社区 Skill 很好用，可以改成自己的版本吗？

A：可以，而且很推荐。你可以把社区 Skill 当模板复制一份，再根据自己的业务流程、输出格式、术语和示例进行调整。

Q9：技能创建后效果不好怎么办？

A：先用真实任务测试，再根据输出问题补充指令。常见优化方向包括：补充触发场景、明确输出格式、增加反例、加入示例、拆清楚执行步骤。

八、练手小作业