零基础教程:手把手教你给 VS Code Copilot “装上 Agent Skills

Agnet Skills

1. 什么是 Agent Skills?(一句话听懂)

如果说**“自定义指令”是给 Copilot 的脑子里刻了一句话;那么 “Agent Skills” 就是给 Copilot 发了一套“带说明书的工具箱”**。

  • 它的好处:平时不占脑容量,只有当你提到相关活儿时,它才会精准启动。

  • 它的威力:它不仅有文字,还能带参考文件、脚本代码,甚至是一整套工作流。


2. 第一步:创建“技能存放处”

首先,我们要告诉 VS Code,你的技能包放在哪里。

  1. 在你的项目最外层文件夹,右键新建一个文件夹,起名:.github(注意前面有个点)。

  2. 进入 .github 文件夹,再新建一个文件夹,起名:skills

  3. skills 里面,为你这个具体的技能建一个文件夹。比如我们要写一个关于“GEO AI 网页转换”的技能,就叫 geo-helper

现在的文件夹长这样:

你的项目/
    └── .github/
        └── skills/
            └── geo-helper/  <-- 你的技能包就在这




3. 第二步:写一份“技能说明书” (SKILL.md)

geo-helper 文件夹里,新建一个文件,名字必须SKILL.md

把下面的内容复制进去,这是 Copilot 识别它的唯一凭证:

---
name: geo-helper
description: 专门处理 GEO AI 生成系统的网页转换。当用户提到“转换模板”、“GEO 优化”或“处理 HTML”时启动。
---

# 技能指令(这是你教它怎么干活的地方)
你现在是 GEO AI 架构师。

## 你的任务
1. 把 HTML 里的静态标题换成 {pboot:title}。
2. 检查所有的图片路径,加上我们的服务器前缀。
3. 参考这个文件夹里的 [standard-template.txt](./standard-template.txt) 来对比格式。

## 禁令
- 不准修改原始的 CSS 类名。
- 必须保留中文注释。

小白必读:

  • name: 这是技能的 ID,只能用小写字母和横线。

  • description: 这是最重要的! Copilot 会根据这段描述来决定什么时候“变身”成这个技能专家。


4. 第三步:给工具箱塞进“参考资料” (进阶绝招)

这是 Agent Skills 区别于普通指令的地方。在同一个 geo-helper 文件夹里,你可以放任何参考文件。

  • 比如:新建一个 standard-template.txt,里面放上你最满意的代码范例。

  • SKILL.md 里引用它(就像我上面写的那样:[说明文字](./文件名))。

这样 Copilot 在干活的时候,会自己去翻这个文件看,不用你每次都复制给它。


5. 第四步:如何让它跑起来?

不需要去设置里点任何开关。

  1. 打开 VS Code 的聊天窗口(Copilot Chat)。

  2. 直接像平常一样说话

  • 你问:“帮我把这段代码做一下 GEO 优化。”

  • Copilot 的大脑

  1. 扫描 .github/skills/ 文件夹。

  2. 看到 geo-helper 的描述里写着“GEO 优化”。

  3. 自动加载 SKILL.md 里的所有规则和参考资料。

  4. 给你输出最专业的答案。


6. 小总结:我该选哪种?

如果你还在纠结,看这个表:

需求场景用“自定义指令” (Instructions)用“Agent Skills” (技能包)
存放位置只有一两个 .md 文件一个专属文件夹
内容只有说教说明书 + 脚本 + 样板文件
灵活性所有的对话都带着,容易乱只有相关时才加载,非常干净
便携性只能在 VS Code 里用以后在命令行、GitHub 网页都能用

7. 常见问题 (给小白的叮嘱)

  • 文件夹名别写错:一定是 skills(复数,有个 s)。

  • SKILL.md 名字别写错:全大写,后缀是 .md

  • 描述要写清楚:如果你的 description 写得太模糊,Copilot 可能不知道什么时候该用它。