1.简单介绍

2025年初的时候，当时大家都在积极学习和尝试MCP技术。MCP是Anthropic公司于2024年11月正式推出MCP开放协议，解决了Model和外部系统的连接问题。

到了2025年12月，Anthropic又发布为一项开放标准Agent Skills，Agent Skills允许将特定领域知识打包成独立的Skill，在运行时按需加载到 Agent 的上下文中。

MCP 负责把外部系统连接到AI Model中，解决了连接的问题。Agent Skills 就将一份使用说明书， 负责决定什么时候用哪些工具、怎么组合工具能力，传什么参数给工具等，解决了“使用”的问题。Prompt是一个静态文本，会一次性加载到上下文中，Agent Skills 采用渐进式披露的信息加载方式, 分阶段按需加载内容到上下文中。

2.具体说明

2.1 文件夹结构

Skill以文件夹形式来组织，包含一个 SKILL.md 文件，也可以可选地包含 scripts/、references/、assets/ 等子目录。

        

下面是来自微软开源项目中的Agent Skill示例(unit-converter)，

        

SKILL.md 由 YAML frontmatter（元数据）和 Markdown body（指令内容）组成。

下面是SKILL.md文件的内容，

        

note, 元数据和指令内容的编写需要遵循Agent Skills的规范。Skills 采用渐进式披露的信息加载方式。SKILL.md中的元数据一般小于100 tokens，项目启动时加载所有skill的 name 和 description 字段。Markdown指令内容建议少于 5000 tokens，当某项任务需要激活特定skill时，就会加载整个SKILL.md。执行过程中按需加载 scripts/、references/、assets/ 中的文件。

下面简单尝试一下Agent Skills

2.2 创建Agent Skill

2.2.1 准备阶段

1) 在Visual Studio Code中安装GitHub Copilot Chat extension，

        

note, 安装后，需要使用GitHub帐户登录一下

2) 假定已经编写了一个ASP.NET Web API用来获取2025年亚洲杯球员数据，包含名字，身高，年龄，国家等信息。

        

note, 如果是按照MCP的做法，就需要将这个Web API项目改造成MCP Server了。如果是采用Agent Skills的做法，则还可以这样做。

2.2.2 编写Agent Skill

        

---
name: asia-cup-2025-player-data-analysis
description: asia-cup-2025-player-data-analysis is used to get player data for Asia Cup 2025 and some analysis can be made based on the data, such as the average height or average age for the players by country.
---

To use asia-cup-2025-player-data-analysis, use the following command that get Asia Cup 2025 Player data.

```powershell
(Invoke-WebRequest -Uri 'http://localhost:5000').Content | ConvertFrom-Json
```

在SKILL.md中编写name, description和指令内容。指令内容中包含了PowerShell命令，尝试在本地执行一下，

        

2.2.3 运行一下

在Visual Studio Code中的项目结构如下，只有一个文件，

        

1) 在VSCode中，打开右侧的GitHub Copilot面板，在输入框中输入/skills

        

发现在VSCode顶部弹出的Agent skill列表中可以看到编写的skill，表示配置成功了。

        

2) 在GitHub Copilot输入框中查询一下亚洲杯中国，澳大利亚，日本和韩国的国家篮球队的平均身高，按从高到低排序，

        

在agent task运行过程，需要点击上面图中的确认按钮来启动PowerShell脚本的执行。

3) 由于分析的是中国/澳大利亚/韩国/日本的数据，GitHub Copilot自己编写了一段过滤亚洲杯男篮数据的PowerShell脚本。在执行过程中，点击确定按钮即可。

        

4) 最后的输出结果如下，说明编写的agent skill是运作正常的，

        

5) 检查Web API的后端执行log，确实有提交查询到数据库的，

        

3.总结

本文简单介绍了一下Agent Skill的文件结构和使用过程。更为具体的内容，还可以参考Agent Skills 官方网站。微软在2026年4月3号正式发布了新的AI Agent框架Microsoft Agent Framework 1.0(简称MAF)。当前MAF和Agent Skills的整合还在进行中。在MAF使用中，如果需要执行脚本，还可以使用官方定义的ScriptRunner，它会通过一个本地进程来执行Skill中的脚本。Agent Skills和MAF的内容很多，还需继续跟着微软老师学习一下。

本文如果哪里有错误，麻烦告之，谢谢谢谢！