快速开始

本页为快速开始教程的非官方中文翻译。

快速开始

在本教程中，你将创建一个 Skill，使智能体能够使用随机数生成器来掷骰子。

前置条件

已安装 VS Code 和 GitHub Copilot

译者注：本教程使用 VS Code，但 Agent Skills 是一种开放格式。同样的 Skill 适用于任何兼容的智能体，包括 Claude Code 和 OpenAI Codex。

创建 Skill

一个 Skill 是一个包含 SKILL.md 文件的目录。VS Code 默认在 .agents/skills/ 中查找 Skills。在你的项目中创建 .agents/skills/roll-dice/SKILL.md：

---
name: roll-dice
description: Roll dice using a random number generator. Use when asked to roll a die (d6, d20, etc.), roll dice, or generate a random dice roll.
---

To roll a die, use the following command that generates a random number from 1
to the given number of sides:

```bash
echo $((RANDOM % <sides> + 1))
```

```powershell
Get-Random -Minimum 1 -Maximum (<sides> + 1)
```

Replace `<sides>` with the number of sides on the die (e.g., 6 for a standard
die, 20 for a d20).

就这样 — 一个文件，不到 20 行。以下是每个部分的作用：

name — Skill 的简短标识符。必须与文件夹名称一致。
description — 告诉智能体何时使用此 Skill。智能体据此决定是否激活它。
正文 — 智能体激活 Skill 后遵循的指令。在这里，智能体被指示使用终端命令生成随机数，并将用户请求中的面数替换进去。

试用一下

在 VS Code 中打开你的项目。
打开 Copilot Chat 面板。
在聊天面板底部的模式下拉列表中选择 Agent 模式。
输入 /skills，确认 roll-dice 出现在列表中。如果没有出现，请检查该文件是否位于项目根目录下的 .agents/skills/roll-dice/SKILL.md。
输入：“Roll a d20”

智能体应该会激活 roll-dice Skill。它可能会请求运行终端命令的权限 — 请允许。它将运行该命令并返回 1 到 20 之间的随机数。

译者注：不同模型的工具使用可靠性各异 — 有些模型能稳定遵循 Skill 指令并运行命令，而有些模型则可能尝试自己回答。如果智能体在没有运行终端命令的情况下做出回应，请尝试从模型下拉列表中选择不同的模型。

它是如何工作的

以下是幕后发生的事情：

Discovery / 发现 — 当聊天会话开始时，智能体扫描默认的 Skill 目录并找到你的 Skill。它仅读取 name 和 description，足以判断该 Skill 何时可能相关。
Activation / 激活 — 当你询问掷骰子时，智能体将你的问题与 Skill 的描述匹配，并将完整的 SKILL.md 正文加载到上下文中。
Execution / 执行 — 智能体遵循正文中的指令，将终端命令适配为你请求中的面数。

此过程使用 Progressive Disclosure / 渐进式披露 让智能体可以访问许多 Skills，而无需预先加载所有指令。

下一步

你已经创建了一个可用的 Agent Skill。接下来：

最佳实践 — 如何编写范围合理且有效的 Skills。
优化 Skill 描述 — 测试并改进你 Skill 的描述，使其在正确的提示时被激活。
规范 — SKILL.md 文件的完整格式参考。
示例 Skills — 在 GitHub 上浏览真实世界的 Skills。