什么是 Agent Skill？为什么突然人人都在写？
Agent Skill 是一个文件夹，里面放着一个名为 SKILL.md 的 Markdown 文件。文件内只有三样东西：名称、描述，以及一段告诉 AI 助手如何完成某项特定工作的纯文字指示。没有程序代码，没有 API，同一个文件可在超过 30 款 AI 工具中通用。
Anthropic 于 2025 年 12 月 18 日公布 Agent Skills 规格。48 小时之内，OpenAI 与 Microsoft 已经支持。
真正值得留意的是这个速度。互相竞争的公司极少会如此迅速地就一种文件格式达成共识。他们愿意，是因为问题本身足够普遍：每个人都有一批每日重复输入的提示，却没有办法把它们带到另一个工具。
如果你这星期已经第五次把同一段四百字的简报贴进 ChatGPT，你其实已经完全理解 Skill 要解决什么问题。你正在用人手做一件应该由文件代劳的事。
Skill 与「保存起来的提示」有什么分别？
保存起来的提示要等你去翻出来，Skill 却会自己载入。助手先读描述字段，判断当前请求是否匹配，然后主动把指示拉进来。你完全不需要记得它存在，而这正是它会被真正使用的原因。
这就是抽屉里的食谱卡，与一位早已熟悉这道菜的厨师之间的分别。
第二个分别是可携性。存放在 ChatGPT 自定指示里的提示，只能留在 ChatGPT。为 Claude 撰写的 SKILL.md 文件，可以原封不动地在 OpenAI Codex、GitHub Copilot、Cursor、Gemini CLI、Goose 中运行。截至 2026 年 6 月，agentskills.io 展示页上约有 40 款产品支持此标准。
第三个分别是 Skill 可以交给别人。提示留在你的账户里，文件夹却可以放进共享云端硬盘、代码库，甚至直接用信息传出去。同事把它放进自己的工具，就得到你那一套完整流程。
为什么描述字段比指示内容更重要？
描述是助手在决定要否载入 Skill 之前，唯一会读取的部分。如果它与你实际的说话方式不吻合，Skill 就永远不会启动，指示内容也永远不会被看见。当 Skill 失效，问题几乎总是出在描述，而不是内文。
大多数人第一次撰写时，都会用自己的词汇去描述「这个 Skill 大概是关于什么」。
失败的描述例子：「团队内容指引」。没有人会这样输入，因此它匹配不到任何请求。
有效的描述遵循两段式结构：先讲它做什么，再加一句「Use when」，列出真实用户会用的触发词。
--- 用一句话、以具体名词说明它做什么
--- 「Use when」后面列出 5 至 10 句你真的会输入的话，包括那些写得草率的版本
--- 全长不超过 1,024 字符，这是规格上限
官方规格自己举的例子刻意写得极为直白：「Extract PDF text, fill forms, merge files. Use when handling PDFs.」这正是你需要的语气。不是宣传文案，而是路由指令。
建议最后才写描述。等内文完成之后，你才会清楚这个 Skill 实际覆盖什么范围，而那个范围通常比你最初想像的窄。
如何在 20 分钟内写出第一个 Agent Skill？
挑一项你最常重复解释的工作，把指示写成向一位能干的新同事交代任务的样子，然后存为文件夹内的 SKILL.md。规格只要求两个 frontmatter 字段：name 与 description，其余全部可选。
以下是一个完整可用的 Skill，你可以直接复制、改名、修改。这是真实案例：一份每个客户经理每逢星期五都要从零重写的周报。
把以下内容复制到 SKILL.md
---
name: weekly-client-update
description: Draft the Friday client status update from raw notes. Use when writing a weekly update, client status email, Friday report, progress summary, or when the user pastes messy meeting notes and asks for a client-ready version.
---
# 每周客户更新
把零散笔记整理成可直接发给客户的更新。绝不虚构任何笔记中没有的状态、日期或数字。
## 结构，必须按此顺序
1. 一句标题：本周最重要的一件事。
2. 已完成：客户现在能看见的成果。用点列，过去式。
3. 进行中：正在推进的项目，以及预计完成日期。若我的笔记没有日期，写 TBC 并在文末标示。
4. 受阻：需要客户作决定的事项。写清楚是什么决定，以及截止时间。
5. 下周计划：最多三项。
## 规则
- 全文最多 200 字。
- 不使用「很好」「令人期待」「相当显著」这类形容词。
- 不可只写「我们正在处理」，必须说明下一步是什么、何时完成。
- 若有进度延误，必须写在前两行，不可埋在中段。
- 文末加一节「MISSING」，列出所有被标为 TBC 的项目。
## 完成前检查
重读草稿，删掉任何删去之后不会损失信息的句子。
文件应该放在哪里
两种惯例已经覆盖大部分情况。放在账户层级的文件夹，代表你在任何地方工作都可以用到；放在特定项目内的文件夹，则只在该项目生效，而这正是处理客户专属规则时你想要的效果。在 Claude Code 及大部分兼容工具中，这两个位置分别是个人 skills 文件夹与项目 skills 文件夹。
如果你使用桌面版 AI 应用程序而非终端机，请在设置中寻找 Skills 或 Capabilities 面板。两者的文件格式完全相同。
2026 年有哪些 AI 工具真正支持 Agent Skills？
截至 2026 年 3 月，已有 32 款工具支持该规格；到 2026 年 6 月，agentskills.io 展示页上约有 40 款产品。名单横跨 Anthropic、OpenAI、Microsoft、Google、JetBrains、AWS、Databricks、Snowflake、字节跳动与 Mistral AI。
已具名支持的包括 Claude 与 Claude Code、OpenAI Codex CLI、GitHub Copilot 与 VS Code、Cursor、Gemini CLI、Block 的 Goose、AWS Kiro、Sourcegraph Amp，以及 JetBrains Junie。
但你必须诚实看待这份名单，因为它会影响你该先写哪一个 Skill。这 40 款产品中相当大一部分是开发者工具，运行于终端机或 IDE。如果你的日常是电子表格、演示文稿与电邮，真正与你相关的是桌面版与网页版助手，不是那些命令行工具。
另外两个里程碑说明这个生态并非停留在公告阶段。Vercel 于 2026 年 1 月 20 日推出 skills.sh，一个支持命令行安装的市集。AWS 则于 2026 年 2 月 5 日在 Kiro IDE 中加入 Agent Skills 支持。
实际结论是：可携性现在真的有价值。你本月撰写的 Skill，明年换助手时大概不会被困死在原地，而你过去建立的任何提示库都没有这种待遇。
Agent Skills 会在哪些地方失效？
Skill 失效有四种可预测的模式：描述与真实说话方式不符、一个 Skill 想涵盖太多工作、指示长到挤占了真正任务的空间，以及没有人检查 Skill 究竟有否启动。四者都可以在几分钟内修正，前提是你知道要去看。
一个 Skill，一项工作
一个叫「marketing」的 Skill，同时涵盖社交贴文、电邮、SEO 大纲与广告文案，结果是它不断被触发，却对每一项都帮不上忙。四个范围狭窄的 Skill 永远优于一个包山包海的版本，因为描述可以写得精准。
长度不等于质素
指示会占用上下文窗口中本来应该放你真正文件的空间。SKILL.md 要保持精简，把参考资料推到附带文件，让它只在需要时载入。如果你的 Skill 在第一条指示之前已经写了三千字铺陈，请动手删。
无声的未启动
这一种最浪费时间。你以为 Skill 正在运作，输出看起来也合理，但 Skill 其实从未载入。直接问：「这个答案你用了哪些 skills？」如果答案是没有，问题就在描述。
Skill 不会核实事实
Skill 塑造输出的形态，却不会验证内容。一个写着「绝不虚构数字」的 Skill 能减少虚构数字，却不能消除。每一项声称仍然需要你亲自过目，尤其是价格、日期与人名。这与处理任何 AI 草稿的纪律一致，也正是让 AI 以真实来源文件为依据始终是一个独立且必要步骤的原因。
怎样测试一个 Skill 才敢信任它？
做两个测试：触发测试与盲测。触发测试检查 Skill 是否会在你没有预设的说法下载入；盲测检查输出是否真的比没有 Skill 时更好。两者合计不到十分钟，却能抓出几乎所有问题。
立即试试
打开你的助手，把以下内容贴进去，方括号部分换成你自己 Skill 的工作内容：
我已安装一个负责［撰写每周客户更新］的 skill。以下是真实同事可能提出这项请求的五种说法。请对每一句只回答 YES 或 NO：你会否为这个请求载入该 skill？不要解释，不要放软语气，也不要告诉我描述看起来没问题。
1.「Acme 星期五那份处理好了没有」
2.「客户要下午五点前收到进度」
3.「这是我开会的笔记，帮我整理到可以见人」
4.「起草周报」
5.「我们这星期交了什么」
然后列出这五句之中，所有未出现在我 skill 描述里的触发词。
强迫二元回答是这个提示能够奏效的关键。你叫助手「帮我检视描述」，得到的只会是安慰；强迫它对每一种具体说法表态 YES 或 NO，你才会看见缺口。
接着做盲测。同一份输入，一次启用 Skill，一次移除。如果你分不出两者差别，代表你的指示只是在描述一个能干助手本来就会做的事，这个 Skill 并未赚到它的位置。
这星期应该先写哪一个？
从你已经解释超过三次的工作开始，而不是从最亮眼的那个开始。Skill 的价值来自重复，因此那件沉闷但反覆出现的工作，回报比雄心勃勃的项目快得多。一个范围狭窄、经过测试的 Skill，胜过十个从不启动的 Skill。
值得各花十分钟的候选项目：客户周报、财务同事坚持的报销备注格式、老板对内部公告语气的具体要求、你对外发布任何内容前都会走一遍的检查清单。
这些全都不吸引，却全都是你目前需要反覆解释的事。而每一次重复解释，都是你为「没有把那个文件写出来」而缴的一笔小额税款。
这个格式刻意设计得简单，因为它必须让不写程序的人也读得懂。这正是 Agent Skills 真正的意义所在：配置一件 AI 工具的东西，第一次变成了一份文件，而写文件是你本来就会做的事。
懂AI的冷，更懂你的难 UD 同行28年，让科技成为有温度的陪伴。掌握格式只是容易的那一半，把它变成团队实际运作的一部分，才是大多数人卡住的地方，而这一段没有人应该独自摸索。
把一个 Skill 变成一套真正运作的系统
写出第一个 SKILL.md 只需二十分钟，但要把几个 Skill 整合成全团队倚赖的流程，是另一回事。UD 陪伴香港企业走过 28 年，最清楚技术要落地才有价值。我们手把手带你完成每一步，由挑选该封装哪些工作、测试它是否稳定启动，到部署至整个团队。
本文由 UD AI 团队审阅。
