Skills 技能系统¶

本文你会学到：

• 🧩 Skills 解决什么问题，和自定义指令有什么区别
• ⚡ Skills 的自动触发机制
• 🛠️ 如何创建和管理 Skill
• 💼 实战示例：代码审查 Skill、文档生成 Skill

打个比方：如果自定义指令是给 Copilot 的入职手册（始终生效的规则），那 Skill 就像是岗位操作指南——只有当 Copilot 被安排做特定工作时才拿出来参考。比如"生成测试"时参考测试指南，"写文档"时参考文档指南。

⚖️ Skills 与指令的区别¶

为什么两者都需要？因为指令文件会始终占用上下文窗口——如果你把所有操作指南都塞进指令文件，上下文窗口会被挤满，Copilot 的响应质量反而下降。Skill 只在需要时加载，更节省上下文空间。

🎯 自动触发机制¶

Skill 的核心特性是自动触发——你不需要手动激活它，Copilot 会根据你的 prompt 自动判断是否加载。判断依据是 Skill 的 description 字段。

1
2
3
4
5
6
7
8
9

# SKILL.md 中 description: "为 Web 应用生成端到端测试，使用 Playwright 框架"

# 以下 prompt 会自动触发该 Skill：
> 为登录页面生成 Playwright 测试
> 写一个端到端测试覆盖购物车流程

# 以下 prompt 不会触发：
> 修复 CSS 样式问题
> 优化数据库查询

匹配原理¶

自动触发基于**关键词语义匹配**：Copilot 将用户 prompt 与所有 Skill 的 description 进行比对，找出语义最相关的 Skill 加载到上下文中。匹配过程是异步的，不会显著增加响应延迟。

1
2
3
4
5
6
7

# 匹配流程

用户输入 prompt
  → Copilot 提取 prompt 的核心意图
  → 将意图与所有 Skill 的 description 进行语义匹配
  → 匹配得分最高的 Skill（超过阈值）被自动加载
  → Skill 指令注入到当前对话上下文中

手动调用 vs 自动触发¶

🛠️ 创建 Skill¶

目录结构¶

每个 Skill 拥有独立目录，目录名使用小写字母加连字符：

1
2
3
4
5

.github/skills/webapp-testing/
├── SKILL.md          # 必须命名为 SKILL.md（大写）
├── example-test.ts   # 可选：示例文件
├── templates/        # 可选：模板目录
└── config.json       # 可选：配置文件

SKILL.md 格式¶

由 YAML Frontmatter 和 Markdown 正文两部分组成：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

---
name: webapp-testing
description: 为 Web 应用生成端到端测试，使用 Playwright 框架。当用户要求生成 E2E 测试、集成测试或 UI 测试时使用此技能。
---

# Web 应用端到端测试

## 测试结构
- 使用 Page Object 模式组织测试
- 每个页面对应一个 Page Object 类
- 测试文件放在 `tests/e2e/` 目录

## 测试规范
- 每个测试用例独立运行，不依赖其他测试的状态
- 使用 `test.describe` 按功能分组
- 使用 `test.beforeEach` 做通用初始化

## 示例
参考 `example-test.ts` 中的写法。

Frontmatter 字段¶

📂 Skills 存放位置¶

🎮 使用 Skill¶

自动触发¶

大多数情况下，只需要正常写 prompt，Copilot 会自动判断是否需要加载某个 Skill：

1
2
3

# 如果你有一个 webapp-testing Skill
> 为用户注册流程生成端到端测试
# Copilot 自动加载 webapp-testing Skill 并按照其规范生成测试

Skill 指令（SKILL.md 正文）在对话的多个轮次间持久保留（1.0.25 修复）。此前存在一个 bug：Skill 在首轮加载后，后续轮次中指令内容会丢失，导致 Copilot 在长对话中忘记 Skill 的约束。

通过 -i（--interactive）启动时，Skill 斜杠命令（如 /skill-name）现在能在启动时正确识别（1.0.35 修复），此前在非交互模式启动后再切换到交互模式时，Skill 命令可能无法被发现。

显式调用¶

也可以通过 /skill-name 语法显式调用：

1

> 使用 /webapp-testing 为登录页面生成测试

🔧 Skill 管理命令¶

💼 实战示例¶

创建代码审查 Skill¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

---
name: python-review
description: Python 代码审查技能。当用户要求审查 Python 代码、检查代码质量或进行安全审计时自动激活。
---

# Python 代码审查

## 审查清单
1. **类型安全**：检查类型注解是否完整和正确
2. **错误处理**：是否有未处理的异常、空的 except 块
3. **安全性**：SQL 注入、路径遍历、不安全的反序列化
4. **性能**：N+1 查询、不必要的循环、内存泄漏
5. **可维护性**：函数长度、圈复杂度、命名规范

## 输出格式
对每个问题，说明：
- 📍 位置（文件:行号）
- 🏷️ 类别（类型安全/错误处理/安全性/性能/可维护性）
- 📝 问题描述
- ✅ 修复建议

创建文档生成 Skill¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

---
name: doc-generator
description: API 文档生成器。当用户要求生成 API 文档、写 README 或创建使用说明时自动激活。
---

# API 文档生成

## 文档结构
每个 API 端点的文档包含：
- 端点路径和 HTTP 方法
- 请求参数（路径参数、查询参数、请求体）
- 响应格式和状态码
- 使用示例（curl 命令）
- 错误处理说明

## 风格要求
- 使用 Markdown 格式
- 代码示例使用代码块并标注语言
- 参数说明使用表格

🔗 在 Agent 中预加载 Skills¶

Agent 可以通过 frontmatter 中的 skills 字段**预加载**指定的 Skills 到上下文。这意味着当该 Agent 被激活时，列出的 Skills 会自动注入，无需依赖 prompt 匹配。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

---
name: code-reviewer
description: 专业的代码审查 Agent，审查代码质量、安全性和可维护性
skills:
  - python-review
  - security-audit
---

# 代码审查 Agent

你是一位资深代码审查专家。在审查代码时，严格按照预加载的 Skill 规范执行。

适用场景¶

⚖️ Skills vs Agent vs 指令 vs MCP¶