Agent Skills快速入门：5分钟创建你的第一个AI技能扩展

gitblog_00050

437人浏览 · 2026-07-03 07:04:39

gitblog_00050 · 2026-07-03 07:04:39 发布

Agent Skills快速入门：5分钟创建你的第一个AI技能扩展

【免费下载链接】agentskills Specification and documentation for Agent Skills 项目地址: https://gitcode.com/GitHub_Trending/ag/agentskills

你是否曾想过让AI助手变得更智能、更专业？🤔 Agent Skills就是实现这一目标的终极解决方案！这是一种轻量级、开放的格式，专门用于扩展AI代理的能力，让它们能够掌握专业知识和工作流程。无论你是开发者、数据分析师还是内容创作者，都可以通过创建Agent Skills来定制你的AI助手，让它成为你的专属专家助手。

什么是Agent Skills？🎯

Agent Skills是一种标准化的技能扩展格式，通过简单的文件夹结构为AI代理添加专业能力。每个技能都是一个包含SKILL.md文件的文件夹，这个文件定义了技能的元数据和执行指令。想象一下，你可以为AI助手添加"数据分析"、"代码审查"、"文档生成"等各种专业技能！

为什么需要Agent Skills？✨

AI代理虽然强大，但往往缺乏特定领域的专业知识。Agent Skills解决了这个问题，它能够：

封装专业知识：将专业知识和团队特定工作流程打包成可重用的技能
实现可重复工作流：将多步骤任务转化为一致、可审计的流程
跨产品复用：一次构建，在任何兼容的AI工具中都能使用

创建你的第一个技能：掷骰子🎲

让我们用5分钟时间创建一个简单的掷骰子技能。这个技能将教会AI如何生成随机数来模拟掷骰子。

步骤1：创建技能文件夹

在你的项目根目录下创建以下文件夹结构：

.agents/skills/roll-dice/

步骤2：编写SKILL.md文件

在roll-dice文件夹中创建SKILL.md文件，内容如下：

---
name: roll-dice
description: 使用随机数生成器掷骰子。当被要求掷骰子（d6、d20等）、掷骰子或生成随机骰子结果时使用此技能。
---

要掷骰子，请使用以下命令生成从1到给定面数的随机数：

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

Get-Random -Minimum 1 -Maximum (<面数> + 1)

将<面数>替换为骰子的面数（例如，标准骰子为6，d20为20）。


### 技能结构解析

- **name字段**：技能的简短标识符，必须与文件夹名称匹配
- **description字段**：告诉AI何时使用此技能，这是AI决定是否激活技能的关键
- **正文内容**：AI激活技能后遵循的详细指令

[![技能创建流程](https://raw.gitcode.com/GitHub_Trending/ag/agentskills/raw/0c0c5673846d0a1c983d910b189e329ef3ab8f2a/docs/images/logos/goose/goose-logo-black.png?utm_source=gitcode_repo_files)](https://link.gitcode.com/i/4cff117df7efa1b5658aba475991847e)

## 测试你的技能🚀

现在让我们测试一下刚创建的技能：

1. 在VS Code中打开你的项目
2. 打开Copilot Chat面板
3. 在聊天面板底部的模式下拉菜单中选择**Agent**模式
4. 输入`/skills`确认`roll-dice`出现在技能列表中
5. 提问："掷一个d20"

AI应该会激活`roll-dice`技能。它可能会请求运行终端命令的权限——允许它执行。然后它会运行命令并返回1到20之间的随机数。

## Agent Skills的工作原理🔧

技能激活过程采用**渐进式披露**机制，分为三个阶段：

1. **发现阶段**：AI启动时扫描默认技能目录，仅读取技能的`name`和`description`
2. **激活阶段**：当任务匹配技能描述时，AI将完整的`SKILL.md`内容加载到上下文中
3. **执行阶段**：AI按照正文中的指令执行，根据需要运行代码或加载文件

这种机制让AI能够管理大量技能，而不会占用过多的上下文空间。

## 技能创建最佳实践📝

### 从真实专业知识开始

有效的技能基于真实专业知识创建。避免让LLM凭空生成技能，而应该：

- **从实际任务中提取**：在与AI的对话中完成真实任务，然后将可重用模式提取为技能
- **从现有项目工件合成**：使用团队的实际文档、运行手册和代码审查记录作为素材

### 优化技能描述

技能描述是AI决定是否使用技能的关键。好的描述应该：

- 明确说明技能的功能和使用时机
- 包含特定的关键词，帮助AI识别相关任务
- 长度控制在1-1024个字符之间

### 合理使用上下文

技能激活后，其完整的`SKILL.md`内容会加载到AI的上下文窗口中。每个标记都在与对话历史、系统上下文和其他活动技能竞争AI的注意力。

## 高级技能功能⚡

### 可选字段扩展

除了必需的`name`和`description`字段，你还可以添加可选字段：

```yaml
---
name: pdf-processing
description: 提取PDF文本、填写表单、合并文件。处理PDF时使用。
license: Apache-2.0
compatibility: 需要安装pdftk和ghostscript
metadata:
  author: your-team
  version: "1.0"
allowed-tools: bash python
---

技能目录结构

完整的技能可以包含多个目录：

my-skill/
├── SKILL.md          # 必需：元数据 + 指令
├── scripts/          # 可选：可执行代码
├── references/       # 可选：文档资料
├── assets/           # 可选：模板、资源
└── ...               # 任何其他文件或目录