平时我们用 AI 写代码，最烦的就是它“不听劝”或者“记性差”——每次都要重新告诉它“我的代码要长这样”、“这里要用那个规范”。
Agent Skills（智能体技能） 就是用来彻底解决这个问题的。它能让 AI 变成你肚子里的蛔虫。
一、 核心概念：什么是 Agent Skills？
别被英文名字唬住了。简单来说：它就是一个专门用来存放“规矩”的文件夹。
普通的 AI 像个没经验的实习生，什么都要你教。而 Agent Skills 相当于你给实习生发了一本**“员工手册”**。 只要你把这本手册放在项目的指定位置，AI 平时不会烦你（不占内存）；但只要你提到了相关工作，它就会瞬间翻开手册，变成那个最懂你项目的老员工。
二、 基本用法：3步建好你的“技能包”
我们先来建一个最基础的技能，让 AI 知道从哪里读取你的规矩。
建文件夹：在你的项目最外层，新建一个文件夹叫
.github，然后在里面再建一个叫skills的文件夹。起个技能名：在
skills里面，为你现在的任务建个文件夹。比如我们要做前端网页开发，就建一个文件夹叫web-expert。写说明书：在
web-expert里新建一个文件，名字必须且只能叫SKILL.md。
把下面这段话复制进 SKILL.md 里保存：
---name: web-expertdescription: 专门用来写前端页面的专家。当用户让你写 HTML 或页面时，就会触发这个技能。---# 你的规矩1. 所有的按钮必须加上 class="btn-primary"。2. 不要废话，直接给我代码。
（小白实操：现在你在 VS Code 聊天框里让它“写个登录页按钮”，它就会乖乖加上 btn-primary，因为你的 description 触发了它。）
三、 高级用法：怎么给 AI 塞参考书和工具？（核心实操）
到了你最困惑的地方了。基础用法只能用文字定规矩，但很多时候文字是描述不清楚代码长什么样的。 高级用法（Reference 和 Script）就是让你直接把真实的文件塞给 AI 抄。
1. Reference（挂载参考书）：让 AI “照猫画虎”
痛点：你想让 AI 写一个新页面，结构必须和你之前写的老页面一模一样。你不想每次都把老页面的代码复制给它看。
跟着我做：
放参考文件：在你刚才建的
web-expert文件夹里，新建一个文件叫my-template.html。在里面随便写几行你最满意的标准 HTML 代码结构保存。改说明书：打开你的
SKILL.md，加上下面这句神奇的话：
每次生成新页面时，请不要自己瞎编结构，必须去抄这个文件里的格式：[标准模板](./my-template.html)
见证奇迹：现在你在聊天框对 Copilot 说：“帮我写个注册页面”。结果：AI 会自己顺着那个路径，偷偷打开
my-template.html仔细阅读，然后吐出跟你的模板完美契合的代码！你全程不需要多打一个字。
2. Script（脚本工具）：给 AI 配备“干活工具”
痛点：代码写完了，你通常需要敲命令行来测试或者格式化代码。你希望 AI 能直接告诉你怎么弄，甚至提供现成的测试脚本。
跟着我做：
放脚本文件：在
web-expert文件夹里，放一个你平时用的测试文件或工具文件，比如叫test-demo.js。改说明书：在
SKILL.md里告诉 AI 这个工具是干嘛的：
如果你帮用户写完了 JS 逻辑，请参考 [测试脚本](./test-demo.js) 里的方法，顺便帮用户写好测试代码。测试完成后，请提醒用户在终端运行 node ./test-demo.js
见证奇迹：AI 在帮你写完代码后，不仅逻辑严密，还会像个贴心小助手一样附上测试代码，并教你下一步去终端敲什么命令。这就叫打通了干活的“全流程”。
四、 深度辨析：Agent Skills 和最近很火的 MCP 有啥区别？
如果你在网上查资料，肯定会看到另一个词叫 MCP，小白很容易把这两个搞混。请记住这个最通俗的对比表：
| 区别 | Agent Skills（智能体技能） | MCP（模型上下文协议） |
|---|---|---|
| 它是干嘛的？ | 解决“内部规矩”问题。 比如代码格式、团队模板。 | 解决“外部情报”问题。 比如让 AI 去读公司的数据库、查网页。 |
| 放在哪？ | 就在你当前的代码文件夹里（.github/skills）。 | 是一个需要额外安装的外部程序（服务端）。 |
| 举个栗子 | 让 AI 照着你写好的 template.html 写代码。 | 让 AI 连接到 GitHub 帮你查谁昨天提交了报错的代码。 |
| 小白上手难度 | 极低。建两个文件夹，写几句 Markdown 就能爽。 | 偏高。需要懂点命令行和环境配置。 |
一句话总结：高级玩法根本不复杂，说白了就是把你需要 AI 参考的文件（HTML、JS 等）和 SKILL.md 放在同一个文件夹里，然后在 SKILL.md 里用 [名字](./文件名) 艾特它一下。
你可以现在就打开 VS Code，随便建一个你最常用的 HTML 模板文件放进去试试看。遇到哪一步卡住了，随时告诉我！