VS Code 配置 AI Agent Skills 实战指南
在 VS Code 中配置'Agent Skills'，本质上是为你的 AI 编程助手（如 GitHub Copilot）定制一套可复用的专业能力包。你可以把它理解为一份标准说明书，专门教助手如何执行特定任务。
当你的需求与某个技能描述匹配时，Copilot 会自动加载这个'技能包'，从而更精准地帮你完成任务，比如生成测试用例、调试工作流等。它主要由一个 SKILL.md 文件以及相关的脚本、示例组成。
启用功能
首先确保在设置中启用了相关功能。通常可以在扩展设置或全局配置中找到开关。
技能存放位置
建议在项目根目录或个人配置文件夹中创建特定文件夹来存放技能包。
- 项目级技能：在项目根目录下创建
.github/skills/目录。这会让技能仅作用于当前项目。 - 个人级技能：在用户目录下创建
~/.copilot/skills/（推荐）或~/.claude/skills/。这类技能会对你电脑里所有的项目生效。
技能编写规范
一个标准的技能文件夹结构如下，核心是必须包含 SKILL.md：
my-skill/
├── SKILL.md # 必需：核心入口文件，包含元数据和主要指令
├── references/ # 可选：参考文档（如 API 说明、详细政策）
│ ├── advanced-guide.md
│ └── api-reference.md
├── examples/ # 可选：使用示例
│ └── common-use-cases.md
├── scripts/ # 可选：可执行脚本（Python、Bash、Node 等）
│ └── process_data.py
└── templates/ # 可选：输出模板、品牌资源等
└── report-template.md
哪怕你只写一个简单的规则，SKILL.md 也是必不可少的。
创建技能案例
我们以检查 Vue 项目代码规范的项目技能为例。
存放目录：.github/skills/code-review/
SKILL.md 内容示例：
---
