技能
工具推荐
在 AI IDE 中，技能（Skill）通过 SKILL.md 文件进行定义和管理。每个技能封装了指令、脚本及相关资源，用于为智能体提供可复用、面向特定场景的专业能力。
了解 AI IDE 中的技能
一个技能可以被视为提供给智能体的一套"专业能力说明书"（类似用户手册或操作指南）。在执行任务时，智能体可以按需加载相应的技能，从而增强其对任务的理解与执行能力。
主要特点
主要特点
- 结构化：一个技能对应一个
SKILL.md文件，文件中以结构化的方式描述完成某一类任务所需的信息，例如：任务目标与适用场景；关键约束与注意事项；推荐流程或操作步骤；可选的脚本、模板或示例。 - 动态按需加载：智能体不会在任务开始时一次性读取所有技能的完整内容。在执行任务前，智能体会先扫描所有技能的简要描述，仅当判断当前任务与某个技能高度相关时，才会加载该技能的详细内容。这种按需加载机制可以有效减少上下文中的 Token 消耗、避免无关信息干扰智能体的决策。
使用场景
使用场景
- 保证输出结果的一致性与规范性：需要智能体在不同时间、不同任务中，始终按照既定标准输出结果。例如，将统一设计规范、执行团队标准、保持品牌一致性或确保代码符合项目约定等要求封装为技能，从而将隐性的个人或团队标准转化为显式、可复用的专业能力，最终使输出结果更加稳定、可控。
- 自动化重复性工作流：需要频繁执行相同或高度相似的多步骤任务。例如，对于测试流程、代码规范检查、常规数据分析等难以避免的日常工作，可以将既有的 SOP 封装为技能。一旦相关任务被触发，智能体即可自动按照定义好的流程执行，从而减少重复的指令输入，提升效率。
- 总结与共享专业能力：总结个人经验或团队规范，并在更大范围内复用。例如，将技能在社区、交流群等公共平台进行分享，从而在不同的智能体、项目、团队间复用相同的技能。
技能 vs 其他功能
功能对比
- 技能 vs 规则：规则采用全量加载机制，一旦开启对话，所有规则都会被注入并持续占用上下文窗口；技能则采用按需加载机制，仅在实际需要被调用时才加载到上下文中，从而显著降低 Token 消耗。
- 技能 vs MCP Server：技能用于向 AI IDE 描述如何完成任务，而 MCP Server 负责向 AI IDE 提供可以调用的工具。例如，AI IDE 可以通过 Playwright MCP Server 获得页面操作等自动化测试能力；而对应的技能则用于约定测试工程结构、页面对象模型（POM）设计规范，以及常见测试用例的编写和执行流程，从而引导 AI IDE 在正确的上下文中高效调用这些能力。
支持的技能类型
| 类型 | 描述 |
|---|---|
| 全局技能 跨项目 | 跨项目全局生效的技能，可用于：统一个人/团队的通用开发范式（如统一代码风格、命名规范、注释习惯）；提供跨项目可复用的工程能力（如通用工具链的使用：Git、CI/CD、Playwright 等）；固化个人或组织的长期偏好（如输出结构：是否先给结论、是否列步骤、是否给示例）。 |
| 项目技能 项目内 | 仅在当前项目生效的技能，可用于：注入项目专属的业务知识与规则（如不可违反的业务约束与边界条件、项目内部术语、概念映射）；约束 AI 按项目的既定技术方案工作（如技术栈、框架版本、架构限制等）；让 AI 深度参与当前项目的开发和维护（如针对项目生成测试、Mock、脚手架代码；与项目使用的 MCP Server 或内部工具协同）。 |
技能的结构
一个技能中必须包含一个 SKILL.md 文件，还可以根据实际需求添加其他文件，例如可执行的脚本、可参考的模板和风格指南等。例如：
skill-name/
├── SKILL.md # （必须）智能体的核心指令
├── examples/ # （可选）输入/输出示例
│ ├── input.md
│ └── output.md
├── templates/ # （可选）可复用的模板
│ └── component.tsx
└── resources/ # （可选）参考文件、运行脚本或素材
└── style-guide.md技能所在目录
- 项目技能：项目所在路径下的
.trae/skills/目录。 - 全局技能：
- macOS/Linux：本地根目录
~/.trae-cn/skills - Windows：本地根目录
%userprofile%/.trae-cn/skills
- macOS/Linux：本地根目录
SKILL.md 文件格式
---
name: 技能名称
description: 简要描述这个技能的功能和使用场景
---
# 技能名称
## 描述
描述这个技能的作用。
## 使用场景
描述触发这个技能的条件。
## 指令
清晰的分步说明，告诉智能体具体怎么做。
## 示例 (可选)
输入/输出示例，展示预期效果。创建技能
创建方式推荐
推荐使用方式一（通过对话创建）或方式二（手动创建），简单快捷。
方式一：通过对话，由 AI 自动创建技能
你可以直接通过对话创建技能。你只需向 AI 描述你的需求，AI 就会自动为你生成对应技能的 SKILL.md 文件。例如：
帮我在 ./trae/skills 目录下创建一个新的技能
技能的名字叫 xxx
这个技能可以帮我做以下事情：
- xxx
- xxx
- xxx方式二：手动创建技能
通过指定技能类型、技能名称、描述和指令，手动创建技能。
- 前往 设置 > 规则和技能。
- 在 技能 部分，点击 创建 按钮。
- 在 新建 窗口中，选择 技能类型（全局 / 项目），然后填写 技能名称、描述 和 指令。
| 字段 | 描述 |
|---|---|
| 技能名称 | 为该技能起一个简短且有辨识度的名称。 |
| 描述 | 描述该技能是什么，以及应该在什么情况下被触发。 |
| 指令 | 当该技能被触发时，你希望 AI 遵循哪些规则或信息。 |
- 点击 确认 按钮。
- 对于全局技能，添加后，它会直接出现在 技能 面板的 全局 页签下。
- 对于项目技能，添加后，TRAE 将自动在当前项目的
.trae/skills/{skill_name}目录下新建一个SKILL.md文件。文件内包含你的自定义技能配置。同时，该技能也会出现在 技能 面板的 项目 页签下。
- （可选）对于项目技能，根据指令中的描述，在
{skill_name}文件夹下手动添加所需的脚本等资源。
方式三：手动导入外部技能
若你需要使用外部已创建的技能，可以直接将 SKILL.md 文件或包含 SKILL.md 以及其他相关文件的 .zip 文件导入至 TRAE。
- 前往 设置 > 规则和技能。
- 在 技能 部分，点击 创建 按钮。
- 在 新建 窗口中，上传一个
SKILL.md文件或一个包含SKILL.md文件的 .zip 文件，然后选择 技能类型（全局 / 项目）。- TRAE 会分析所上传的技能文件，然后自动填充 技能名称、描述 和 指令 字段。
- 按需修改 技能名称、描述 和 指令 字段中的内容，然后点击 确认 按钮。
- 对于全局技能，添加后，它会直接出现在 技能 面板的 全局 页签下。
- 对于项目技能，TRAE 将自动在
.trae/skills/目录下新建{skill_name}文件夹，其中包含你所上传的所有文件。同时，该技能也会在 技能 面板的 项目 页签下展示。
启用/禁用技能
创建技能后，你可以通过打开/关闭该技能的开关来启用/禁用它。
使用该能力后，TRAE 会在项目的 .trae/ 目录下创建 skill-config.json 文件。文件内罗列被禁用的项目技能。被禁用的全局技能不会出现在该文件中。
编辑/删除技能
点击目标技能右侧的齿轮图标，然后在菜单中选择 编辑 或 删除，按需完成相应操作。对于项目技能你还可以选择将其 应用到全局。
在对话中使用技能
方式一：手动调用技能
你可以直接向 AI 发送指令，明确告知 AI 调用某个技能来完成任务，例如："用 codemap 技能总结一下这个分支的改动"。
方式二：由 AI 自动调用技能
在执行任务时，AI 会结合当前任务内容与各技能中定义的"适用场景"或"何时使用"之类的描述，判断是否需要加载某个技能，并在合适的阶段自动调用相关技能。
例如，假设你定义了一个代码审核技能，其触发条件为"当用户请求代码反馈或评审时"。当你提出"这个函数写得如何"、"帮我审核以下代码"之类的请求时，AI 会识别到这类请求与代码审核技能的相关性，并在无需额外指令的情况下加载并使用该技能，以完成对应的代码分析与反馈。
最佳实践
最佳实践
Skill 的开发非一蹴而就，而是一个持续迭代的过程。关于构建和迭代 Skill 的最佳实践，参考 如何写好一个 Skill：从创建到迭代的最佳实践。
Skills.sh
Skills.sh 是一个为 AI 助手（如 Claude Code, Cursor, GitHub Copilot）提供技能（Skills）的应用商店，而 skills CLI 工具则是它的命令行入口，可以实现对技能的一键搜索、安装和管理。
🧠 核心概念：为 AI 打造的专业"肌肉记忆"
核心概念
简单来说，大模型是"大脑"，负责思考和规划；而 Skills 则是"肌肉记忆"，为 AI 提供特定领域的知识、流程和最佳实践，让它能更专业地完成特定任务，例如代码审查、生成符合规范的 Vue 组件等。
- 核心文件：
SKILL.md。一个 Skill 本质上是一个文件夹，其核心就是这个 Markdown 文件。 - 按需加载：Skills 只在需要时才会被加载，因此即使在项目中添加大量 Skills，也不会无谓地占用 AI 的上下文窗口。
🚀 使用指南：官方工具 skills CLI
skills CLI 是管理所有 Skills 的官方命令行工具。
安装与查找
# 查找 Vue 相关技能
npx skills find vue
# 查找测试相关技能
npx skills find testing# 尝试不同关键词
npx skills find vue best practices
npx skills find vue testing
# 访问排行榜
# https://skills.sh 网站可按 "All Time"、"Trending" 等标签浏览热门技能安装与管理
安装技能：使用 npx skills add <技能来源>。来源可以是 GitHub 仓库，也可以是本地路径。
安装过程：CLI 会交互式地询问要安装的技能以及要安装到哪个 AI 工具中（如 Claude Code, Cursor 等）。
全局安装与更新：使用 --global 或 -g 标志将技能安装到全局，以便在所有项目中共享。后续可使用 npx skills check 和 npx skills update 命令来检查和更新技能。
✍️ 打造专属技能：编写 SKILL.md
当现有 Skills 无法满足需求时，你可以创建自己的技能。
- 标准目录结构：
my-skill/
├── SKILL.md # 核心文件，包含元数据和指令
├── scripts/ # 可选，存放可执行脚本
├── references/ # 可选，存放详细文档
└── assets/ # 可选，存放模板、图片等资源- 编写核心文件
SKILL.md：文件由两部分组成。- YAML 元数据：位于文件顶部，至少需要定义
name和description。这是 AI 判断何时激活技能的关键。 - Markdown 正文：包含具体的指令、步骤和最佳实践。设计优秀的技能会采用层级结构，并通过引用子文档来避免文件过长。
- YAML 元数据：位于文件顶部，至少需要定义
---
name: my-vue-skill
description: 用于编写符合公司规范的 Vue 3 组件。当用户要求编写或审查 Vue 代码时使用。
---
# Vue 3 组件编写规范
## 核心原则
1. 必须使用 `<script setup>` 语法糖。
2. 使用 TypeScript 定义 Props 和 Emits。
...💎 项目专项技能推荐
对于 Vue 开发者来说，以下技能可以显著提升 AI 辅助编程的效率和质量：
vue3 相关技能
由 Vue 团队成员创建，是 Vue 生态中最核心的技能集。它封装了 Vue 3、Pinia、Vue Router 等最佳实践，旨在"教会 AI 如何正确地写 Vue"。
- 安装：
npx skills add vuejs-ai/skills - 能力：涵盖 Composition API、响应式系统、VueUse、测试等多个方面。
- 使用示例：
- "用 Vue 3 帮我写一个用户列表组件，要求使用 Composition API 和 TypeScript。"
- "审查这段 Vue 代码，检查是否遵循了最佳实践。"
- 设计参考：该技能设计清晰，
SKILL.md作为入口，通过引用子文档来提供详细规范，值得作为编写自定义技能的参考。
Vue 3 相关技能列表
| 技能名称 | 描述 | 安装命令 |
|---|---|---|
| vue-best-practices | Vue 3 组合式 API（Composition API）、<script setup lang="ts">、TypeScript、SSR。包含模板无法满足需求时使用的渲染函数（render functions）。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-best-practices |
| vue-options-api-best-practices | Vue 3 Options API 风格（data()、methods、this 上下文）。每条规则仅展示 Options API 解决方案。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-options-api-best-practices |
| vue-jsx-best-practices | Vue 中的 JSX 语法（例如 class 与 className 的区别、JSX 插件配置等）。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-jsx-best-practices |
| vue-testing-best-practices | 使用 Vitest、Vue Test Utils 进行单元测试，以及使用 Playwright 进行端到端（E2E）测试。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-testing-best-practices |
| vue-router-best-practices | Vue Router 4 的使用模式，包括导航守卫、路由参数以及路由与组件生命周期的交互。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-router-best-practices |
| vue-pinia-best-practices | Pinia 状态管理，包括 store 定义、状态管理模式、store 设置以及与 store 的响应式交互。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-pinia-best-practices |
| vue-debug-guides | Vue 3 调试与故障排查指南：运行时错误、警告、异步错误处理、SSR 水合（hydration）问题等。 | npx skills add https://github.com/hyf0/vue-skills --skill vue-debug-guides |
| create-adaptable-composable | 创建可复用的组合式函数（composables），使用 MaybeRef / MaybeRefOrGetter 作为输入参数模式。 | npx skills add https://github.com/hyf0/vue-skills --skill create-adaptable-composable |
| element-plus-vue3 推荐 | 本技能帮助 AI 在 Vue 3 项目中快速集成与配置 Element Plus 组件库，涵盖安装、主题定制、按需引入等关键步骤。同时，它为每个常用组件提供代码示例和最佳实践，让 AI 能准确生成符合 Element Plus 规范的界面代码。 | npx skills add https://github.com/teachingai/full-stack-skills --skill element-plus-vue3 |
vue2 相关技能
Vue 2 相关技能列表
| 技能名称 | 描述 | 安装命令 |
|---|---|---|
| vue2 | 本技能提供 Vue 2.x 框架的完整开发指南，包括 Options API、组件系统、路由管理、状态管理（Vuex）、生命周期等核心概念和最佳实践。 | npx skills add https://github.com/teachingai/full-stack-skills --skill vue2 |
设计相关技能
设计相关技能列表
| 技能名称 | 描述 | 安装命令 |
|---|---|---|
| ui-ux-pro-max | 本技能把专业设计师的知识库和决策流程打包成一个 AI 可直接执行的"标准操作手册"，让你一句话就能获得专业级的设计方案。 | npx skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --skill ui-ux-pro-max |
| web-design-guidelines | 本技能用于依据 Web 界面指南对 UI 代码执行合规性审核，适用场景包括用户提出"审核 UI"、"检查可访问性"、"设计审计"、"UX 审查"或"对照最佳实践评估网站"等需求时。 | npx skills add https://github.com/vercel-labs/agent-skills --skill web-design-guidelines |
| tailwind-css-patterns | 该技能为 AI 提供 Tailwind CSS v4.1+ 的实用样式模式与最佳实践指南，涵盖响应式布局、组件设计及性能优化，助力构建现代用户界面。 | npx skills add https://github.com/giuseppe-trisciuoglio/developer-kit --skill tailwind-css-patterns |
📚 拓展资源
- 官方技能发现平台：skills.sh
- Agent Skills 官方规范：agentskills.io
- Vercel 官方指南：Agent Skills: Creating, Installing, and Sharing