什么是 Agent Skill？它与提示词有何不同？
Agent Skill 是一个文件夹，里面放着一个 SKILL.md 文件，内含指示，并可选择性附上模板与脚本。当你的请求与它的描述吻合时，AI 助理会自动加载它。提示词只存在于一次对话之中；Skill 安装一次，之后每次相关时都会自我套用。
这就是核心概念，也是 Skill 比又一个提示词书签更重要的原因。你不再需要当那个「记得要贴指示」的人。
Anthropic 的 Agent Skills 官方文档把它形容为「模块化能力」，由三件东西组成：指示、元数据，以及可选的资源。这份清单里没有任何一项需要你写代码。
实际差别在第十次重复时才显现。保存好的提示词，你依然要找出它、贴上它，还要记得哪个版本才是好的那个。Skill 只有一个正式位置，助理会自行读取。
为何处理重复工作时 Skill 胜过保存的提示词？
因为渐进式披露（progressive disclosure）。Skill 分阶段加载，而不是把所有内容一次塞进上下文窗口。任何时候常驻于上下文的只有名称与描述，每个 Skill 约 100 个 token，所以你可以安装大量 Skill，而在某一个真正被触发之前，你都不用为它付上下文成本。
Anthropic 的文档列出三个加载层级。理解这三层，正是「写出能用的 Skill 的人」与「写出四千字巨型提示词的人」之间的分野：
--- 第一层：元数据，永远加载，启动时即加载。每个 Skill 约 100 token，只包含 YAML frontmatter 中的 name 与 description。
--- 第二层：指示，只在 Skill 被触发时加载，目标为 5,000 token 以内，即 SKILL.md 的正文。
--- 第三层：资源与代码，只在被引用时加载，未访问前成本为零。可以是额外的 markdown 文件、模板、参考资料或脚本。
第三层的行为，是大多数人忽略的重点。你可以把一份四十页的品牌指引、完整产品目录、六个示范输出全部打包进一个 Skill，而在助理真正需要其中某个文件之前，这些内容都不占用你的上下文。
脚本在这一点上更出色。当助理执行打包好的脚本时，脚本的代码永远不会进入上下文窗口，只有输出结果会。因此一个两百行的格式化脚本，比要求模型即场生成同等逻辑更便宜，也更可靠，因为每次执行的都是同一段代码。
不写代码，如何建立自定义 Skill？
写一个名为 SKILL.md 的纯文本文件，在顶部放上包含 name 与 description 的 YAML frontmatter，下面用普通 markdown 写你的指示，然后把文件夹压缩成 zip 上传。在 claude.ai 上，上传位置是 Settings > Features。不用终端、不用代码库、不用构建流程。
挑一件你每周都重复、而且你已经有明确意见的工作。客户邮件回复、每周报告格式、符合品牌语气的社交媒体文案。最好的第一个 Skill，是一个你已经清楚知道「错」是什么样子的流程，因为那份判断正是你要编码下来的东西。
以下是一个完整、可直接复制使用的起点。把方括号部分换成你自己的内容，就是一个可用的 Skill：
可直接使用的 SKILL.md 模板：
---
name: weekly-client-report
description: 以我们的固定格式撰写每周客户进度报告。当用户要求每周报告、客户更新、进度摘要，或提到要向客户汇报时使用。
---
# 每周客户报告
## 何时使用
当用户要求每周客户报告或进度更新时使用。
## 必须遵守的结构
1. 一句标题：本周最重要的一件事。
2.「本周已完成」：三至五点，每点以动词开头。
3.「进行中」：项目、负责人、预计日期。
4.「需要你决定」：最多两项。若没有，写「没有事项被阻塞」。
5. 以下次会议日期结尾。
## 语气规则
直接、简短。不要用形容词赞美我们自己的工作。永不写「我们很高兴」或「我们一直努力」。
用数字取代形容词：写「加载时间由 4.1 秒降至 1.3 秒」，不要写「性能大幅改善」。
## 绝对不要这样做
不要编造数据。若缺少数字，写「[需补数字]」让人手填写。
全文不得超过 350 字。
这就是一个真正的 Skill。它大约两百字，完全没有代码，而且它产出的报告，会比你每个星期五凭记忆重打一次的提示词更一致。
留意它有效的原因：它定义了结构，用具体的前后对比定义了语气，并且明确点出要避免的失败模式。指示模糊，输出就模糊，无论它是放在提示词还是 Skill 里。
自定义 Skill 可以在哪里使用？需要什么条件？
自定义 Skill 可在 claude.ai、Claude Code 以及 Claude API 上使用，但每个界面各有自己的上传途径与条件。在 claude.ai，你透过 Settings > Features 上传 zip 文件，适用于 Pro、Max、Team 与 Enterprise 方案，并且必须先启用代码执行功能。
根据 Anthropic 的文档，三条途径如下：
--- claude.ai：于 Settings > Features 上传 zip，需启用代码执行。Skill 属于个别用户，不会在组织内共享。
--- Claude Code：基于文件系统，完全不需上传。把文件夹放进 ~/.claude/skills/（个人）或项目内的 .claude/skills/。
--- Claude API：透过 /v1/skills 端点上传，需要代码执行工具与 skills-2025-10-02 beta header，Skill 于整个 workspace 共享。
另有四个预建 Skill 完全无需设置：PowerPoint（pptx）、Excel（xlsx）、Word（docx）与 PDF。如果你曾经好奇为何要求一份有格式的电子表格，有时真的会得到可用文件，那正是预建 Skill 在运作。
对实务工作者而言，claude.ai 那条路径才是关键，而且值得在花一小时撰写之前先确认你的方案。代码执行必须开启，否则上传选项的表现不会如你预期。
什么决定 Skill 是否真的会被触发？
是 description 字段。它是助理在决定是否加载之前唯一看到的部分，因此它必须同时说明「这个 Skill 做什么」与「什么时候该用」。只写了功能而没写使用时机的描述，会一直闲置，而你则在纳闷为何毫无反应。
比较以下两个版本。第一个是大多数人会写的，第二个才是真正会触发的：
--- 弱：description: 协助处理客户报告。
--- 强：description: 以我们的固定格式撰写每周客户进度报告。当用户要求每周报告、客户更新、进度摘要，或提到要向客户汇报时使用。
强的版本列出了你实际会输入的字词。这正是机制所在：你的请求是与描述进行比对，所以描述应该收录你的用语，而不是一段整齐的抽象摘要。
在命名之前，有几个硬性限制值得知道。name 字段最多 64 个字符，只能使用小写字母、数字与连字号，且不能包含保留字「anthropic」或「claude」。description 最多 1,024 个字符。两个字段都不得包含 XML 标签。
把描述的字数用尽。1,024 个字符足以容纳十多个触发用语，而每多一个用语，就是多一个机会让 Skill 接住你在某个星期二用了不同说法的请求。
有哪些没人提醒你的陷阱？
自定义 Skill 不会跨界面同步。你上传到 claude.ai 的 Skill 无法在 API 使用，透过 API 上传的 Skill 不会出现在 claude.ai，而 Claude Code 的 Skill 与两者都是独立的。每个界面都要你自己维护，因此版本走样是真实存在的风险。
另有三项限制会改变你规划 Skill 的方式：
--- 在 claude.ai 上，自定义 Skill 以用户为单位。每位团队成员都要自行上传一份，也没有集中式的管理员派发功能。所谓「团队标准」Skill，是一个你传给大家的文件，而不是某人一键开启的设置。
--- 在 Claude API 上，Skill 运行于沙盒容器内，没有网络访问，也不能在执行时安装包。需要调用外部服务的 Skill 在这里无法运作。
--- 在 Claude Code 中，Skill 拥有与你电脑上任何程序相同的网络与文件系统权限。这既强大，也正是下一点如此重要的原因。
把安装 Skill 当作安装软件看待。Anthropic 的文档在这点上异常直白：只使用你自己建立、或由 Anthropic 提供的 Skill，因为恶意 Skill 可以引导助理以不符其宣称用途的方式调用工具或执行代码。会从外部网址抓取数据的 Skill 风险特别高，因为抓取回来的内容本身可能夹带指令。
审查其实不复杂。打开文件夹里每一个文件，包括脚本，找出任何与该 Skill 宣称功能不符的内容。意料之外的网络调用与奇怪的文件访问，就是信号。
关于这项技术本身，也有一个诚实的限制：Skill 救不了一个你尚未想清楚的流程。撰写 Skill 会迫使你明确指定结构、语气与失败模式。如果你无法描述某项工作「做得好」是什么样子，那个 Skill 就会和你原本的提示词一样模糊，你只是白白多了一个文件。
如何在接下来 20 分钟内实测？
回想你最近三次把同一段指示贴进对话的情况。打开那些对话，复制你贴过的内容，用上面的模板整合成一个 SKILL.md。然后在不贴任何东西的情况下发出同样的请求，再比较输出。
把它拆成五个具体步骤执行：
--- 第 0 至 5 分钟：找出你那三段重复的指示。记下你当时实际输入的请求用语。
--- 第 5 至 12 分钟：撰写 SKILL.md。名称、包含那些实际用语的描述、结构规则、语气规则，以及一个「绝对不要这样做」的段落。
--- 第 12 至 15 分钟：把文件夹压缩成 zip，在已启用代码执行的情况下，透过 Settings > Features 上传。
--- 第 15 至 18 分钟：在全新对话中用你自然的说法提出请求，什么都不要贴。
--- 第 18 至 20 分钟：若没有触发，就在描述中再加三种说法。这几乎总是问题所在。
第一次尝试时应预期的失败模式，是 Skill 完全不启动。原因几乎总是描述，而不是指示。先扩充触发用语，再去动其他任何东西。
一旦第一个 Skill 成功，第二个只需十分钟。复利效果才是重点：每一件被编码下来的重复工作，都是一件你不再需要重新解释的工作，而每次你察觉到不想要的输出，指示都会变得更好。
如果你想再往前一步，Skill 与我们之前谈过的两件事天生互补：正确设置 AI 记忆，让助理长期记住你的固定背景；以及连接 MCP 服务器，让它能触及你工作真正所在的工具。Skill 告诉它怎样做，记忆告诉它你是谁，MCP 告诉它数据在哪里。
重点总结
Skill 把你的专业从脑袋里、从剪贴板里移出来，变成一个助理会自行读取的文件。技术门槛是一个 markdown 文件；真正的门槛，是明确说出「做得好」是什么样子。
后者是没有人能代你完成的工作，也正是杠杆所在。每一小时用来写下你希望某件事怎样被完成，都是你此后再也不用花时间解释的一小时。
懂AI的冷，更懂你的难。UD 同行28年，让科技成为有温度的陪伴。
把一个 Skill 变成一套可运作的系统
一个 Skill 每周为你省下一小时；一组互相连接的 Skill，会改变整个团队的工作方式。UD 帮你从单一个 SKILL.md 文件，走到一套稳定运行的 AI 工作流程，手把手带你完成每一步，从挑选该编码哪些工作、工具配置，到在团队内部署。
由 UD AI 团队审阅。本文事实已于 2026 年 8 月 3 日对照 Anthropic 官方 Agent Skills 文档核实。产品行为与方案要求会变动，在依赖某项具体设置之前，请先查阅官方文档。
