核心功能
Skill
Skill 是教 Agent 如何完成特定任务的 Markdown 文件。你可以把它理解为一份「工作手册」——定义好规范和步骤后，Agent 会在合适的场景下自动应用，让重复性工作变得标准化、可复用。
在对话框中输入 @ 即可唤起 Skill 列表，选择后 Agent 会按照 Skill 中定义的方式工作：
管理 Skill
在 Agents 设置 > 技能 面板中，你可以查看所有已安装的 Skill，包括手动创建的 User Skills 和通过插件安装的 Plugin Skills。
- 使用 开关按钮 启用或禁用 Skill
- 点击 编辑图标 修改 Skill 内容
- 点击 删除图标 移除 Skill
- 点击 Open Folder 直接打开 Skill 文件所在目录
Skill 类型
| 类型 | 存储位置 | 生效范围 |
|---|---|---|
| User Skills | ~/.claude/skills/ | 所有项目通用 |
| Plugin Skills | 由插件提供 | 安装插件后自动可用 |
| Project Skills | 项目的 .claude/skills/ | 仅当前项目生效 |
创建 Skill
点击 + 添加用户技能 进入创建界面，填写三个字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 名称 | 必填 | Skill 的唯一标识，用于匹配和调用（如 explaining-code） |
| 描述 | 必填 | 简要说明用途和触发场景，Agent 根据此内容自动匹配你的请求 |
| 详情 | 必填 | 用 Markdown 编写的完整指令，定义具体的工作规范和步骤 |
提示：描述写得越精准，Agent 的自动匹配越准确。建议包含关键触发词，比如"当用户询问代码原理时"。
编辑 Skill
点击已有 Skill 的编辑图标，进入编辑界面。你可以修改名称、描述和详情内容，也可以点击 Edit in VSCode 在编辑器中打开完整的 Markdown 文件进行更细致的编辑。
配置文件结构
Skill 本质上是一个 Markdown 文件，包含 YAML frontmatter 和正文指令：
---
name: explaining-code
description: 用可视化图表和类比解释代码
---
# 解释代码规范
解释代码时，始终包括：
1. **从类比开始**：将代码与日常生活中的事物进行比较
2. **可视化图表**：使用 ASCII 图表显示流程
3. **逐步分解**：清晰地解释每个部分
支持引用文件
Skill 目录下可以放置参考文档，Agent 只在需要时才读取，避免占用上下文：
my-api-guide/
├── SKILL.md # 核心指令
├── api-reference.md # API 详细文档
└── examples.md # 使用示例
使用方式
| 方式 | 说明 |
|---|---|
| 自动触发 | 当你的请求与 Skill 描述匹配时，Agent 会询问是否使用 |
| 手动调用 | 在对话框输入 @，从 Skill 列表中选择 |
常见问题
Plugin Skill 和 User Skill 有什么区别？
Plugin Skill 由插件提供，安装插件后自动可用。User Skill 由你手动创建，可以完全自定义。如果两者同名，User Skill 优先级更高。
Skill 可以包含代码脚本吗？
可以。Skill 可以包含 Python、Node.js 等任何语言的脚本。Agent 可以执行这些脚本，只有脚本输出会占用上下文，而不是脚本内容本身。
如何分享 Skill 给团队？
两种方式：
- 创建 Project Skill 并提交到代码仓库，团队成员 clone 后自动获得
- 将 User Skill 文件夹分享给团队，复制到
~/.claude/skills/即可