快速入门

创建你的第一个 Agent 技能，并观察它在 VS Code 中的工作方式。

Documentation Index
Fetch the complete documentation index at: https://agentskills.io/llms.txt

Use this file to discover all available pages before exploring further.

在本教程中，你将创建一个技能，赋予智能体使用随机数生成器掷骰子的能力。
代理技能
先决条件
使用 GitHub 副驾驶的 VS Code
本教程使用 VS Code，但 Agent Skills 是开放格式。同样的技能适用于任何兼容的 Agent，包括 Claude Code 和 OpenAI Codex。
(1)
创建技能
Skill 是包含 SKILL.md 文件的文件夹。VS Code 默认在.agents/skills/中查找 skill。在项目中创建.agents/skills/roll-dice/SKILL.md:

.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:

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

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——技能的简短标识符。必须与文件夹名称匹配。
描述——告诉特工何时使用这个技能。这是特工决定是否激活它的方式。
身体——当技能激活时，智能体遵循的指令。在这里，智能体被指示使用终端命令生成一个随机数，替换用户请求的边数。
(1)
试试看
在 VS Code 中打开你的项目。
打开 “副驾驶聊天” 面板。
从聊天面板底部的模式下拉菜单中选择 Agent 模式。
键入/skills 以确认 roll-dice 是否出现在列表中。如果不是，请检查文件是否相对于项目根位于.agents/skills/roll-dice/SKILL.md。
问:“滚动一个 d20”
智能体应该激活骰子技能。它可能会请求许可运行终端命令——请允许。它将运行命令并返回一个 1 到 20 之间的随机数字。
工具使用的可靠性因模型而异——有些模型会遵循技能说明并始终运行命令，而其他模型可能会尝试自行响应。如果智能体响应时没有运行终端命令，请尝试从模型下拉列表中选择不同的模型。
(1)
它是如何工作的
以下是幕后发生的事情：
发现——当聊天会话开始时，代理扫描默认技能目录并找到你的技能。它只读取名称和描述，仅足以知道何时该技能可能相关。
激活——当你询问掷骰子的问题时，代理会将你的问题与该 skill.md 的描述相匹配，并将完整的 SKILL.md 主体加载到上下文中。
执行——代理按照身体中的指示，根据您请求的方数调整终端命令。
这个过程使用渐进式披露，让代理人能够访问许多技能，而无需提前下载所有说明。