一个文件夹教会 AI 办事:Agent Skills 入门
2026年10月22日 Agent Skills 捐给 AAIF。一文说清技能包是什么、为何重要,并手把手写「会议纪要→待办」SKILL.md。
2026 年 10 月 22 日,Anthropic 把开放标准 Agent Skills 捐赠给了 Linux 基金会旗下的 Agentic AI Foundation(AAIF)。听起来像行业公告,其实和普通人关系不小:以后你给 AI 写的「办事规矩」,有望在 ChatGPT、Cursor、GitHub Copilot、VS Code 等一大批产品里通用,而不是绑死在一家工具上。
本文用白话说清三件事:Agent Skills 是什么、这次捐赠意味着什么,以及如何亲手写一个最小可用的 SKILL.md 技能包。
先搞懂:什么是 Agent Skills?
据官方站点 agentskills.io 介绍,Agent Skills 是一种轻量、开放的格式,用来给 AI 智能体补充「专门知识和固定流程」。
它的核心很简单:一个技能 = 一个文件夹,里面至少有一份 SKILL.md。这份文件用 YAML 写清名称和用途描述,再用 Markdown 写出具体操作步骤。需要的话,还可以附带脚本、参考文档、模板等资源。
典型结构大致是:
my-skill/
├── SKILL.md # 必需:元数据 + 操作说明
├── scripts/ # 可选:可执行脚本
├── references/ # 可选:详细参考
└── assets/ # 可选:模板、素材
可以把它理解成「给 AI 的岗位手册」:不是再教它认字,而是告诉它——遇到周报、会议纪要、报销核对这类事时,按哪套流程、用什么格式、注意哪些边界。
Anthropic 在公告中提到,这项能力最初在 Claude Code 里落地:模型做通用知识工作还可以,但往往缺少真实业务里的「程序性知识」。2025 年 12 月标准公开后,开发者很快在 GitHub 上发布大量技能,并为多种客户端写了加载器。
为什么这次捐赠值得关注?
捐赠不只是「换个托管方」,而是把标准放到更中立的治理框架里。
根据 Anthropic 2026 年 10 月 22 日的公告:
- 捐赠内容包括 Agent Skills 的名称与标识、GitHub 组织,以及 agentskills.io 域名。
- 自 2025 年 12 月公开开放标准以来,已有 70 多家 智能体平台接入,其中包括 ChatGPT、Cursor、GitHub Copilot、VS Code。
- 据 Anthropic 介绍,已有约 100 万 个技能被发布,安装量接近 2.8 亿 次。
- 标准将由 Anthropic、Google、OpenAI 等公司工程师以个人身份参与维护,首席维护者(Lead Maintainers)为 David Soria Parra 与 Mahesh Murag。
- 不加入 AAIF 也可以继续使用或贡献 该标准。
同一天,Linux 基金会旗下 AAIF 还宣布了另外三个新项目:OpenAI 贡献的 Open Responses、Hugging Face 贡献的 OpenEnv、阿里巴巴贡献的 OpenSandbox。AAIF 由此从年初起步时的少数项目,扩展到 10 个 托管项目,覆盖「智能体怎么获得技能、应用怎么跨厂商对话、训练环境、安全沙箱」等不同层次。
对普通用户和独立开发者来说,最实在的意义是:同一套技能文件夹,更有机会跨产品复用;标准演进也会更依赖社区提案,而不是某一家公司的内部决策。Anthropic 还提出后续路线图方向,包括版本化发布、正式提案流程,以及面向编写与安装技能的安全指引。
技能怎么被「一点点装进」AI 的脑子?
Agent Skills 采用所谓的 渐进式披露(progressive disclosure),分三阶段加载,避免一上来就把全部说明书塞进上下文:
- 发现:启动时只读每个技能的
name和description,知道「大概什么时候该用」。 - 激活:当前任务和描述对上了,再读入完整的
SKILL.md正文。 - 执行:按说明干活;需要时再打开脚本、参考文件或模板。
因此,写好 description 特别关键——它既是「广告语」,也是触发开关。写太糊,AI 想不到用你;写太宽,又会乱触发。
动手:写一个「会议纪要 → 待办」小技能
下面做一个最小例子:把会议记录整理成可执行待办清单。全程只需一个文件夹和一份 SKILL.md。
第 1 步:建文件夹
在项目里新建目录(路径因客户端而异;VS Code / Copilot 常见默认位置是 .agents/skills/):
.agents/skills/meeting-notes-to-todos/
注意:文件夹名应与下面 name 字段一致。
第 2 步:写 SKILL.md
根据 agentskills.io 规范,name 需小写字母、数字和连字符,最长 64 字符;description 应说明「做什么」和「何时用」。正文写清步骤、输出格式和边界情况即可。
---
name: meeting-notes-to-todos
description: 把会议纪要或讨论记录整理成带负责人与截止日期的待办清单。在用户提到会议纪要、会议记录、action items、待办、跟进事项时使用。
---
# 会议纪要转待办
收到会议内容后,按下面步骤处理:
1. 先用 2~4 句话概括会议主题与结论,不要复述全文。
2. 从文本中提取行动项。每条必须尽量包含:
- 任务内容(动词开头,可执行)
- 负责人(原文未写则标为「待指定」)
- 截止日期(原文未写则标为「待确认」)
3. 忽略闲聊、寒暄和已完成事项。
4. 若同一事项被多人重复提到,合并为一条并注明相关人。
5. 输出使用如下 Markdown 表格:
| 序号 | 待办 | 负责人 | 截止日期 | 优先级 | 备注 |
| --- | --- | --- | --- | --- | --- |
| 1 | … | … | … | 高/中/低 | … |
最后追加「风险与阻塞」小节:列出依赖外部确认、资源未到位的事项。若原文信息不足,明确写出还需要用户补充什么,不要编造。
第 3 步:在支持技能的客户端里试用
以 VS Code + GitHub Copilot 为例(官方 Quickstart 同类流程):打开 Agent 模式,确认技能出现在技能列表中,然后粘贴一段会议记录并说「按会议纪要技能整理成待办」。若客户端会请求运行终端命令或读文件,按需授权即可。
同一份文件夹,在其他兼容 Agent Skills 的产品中,原则也类似:放到该产品约定的 skills 目录,让智能体按描述自动匹配。
写技能时的几个实用建议
- 描述里写触发词:例如「会议纪要 / action items / 待办」,提高命中率。
- 步骤要可执行:用「先……再……最后……」,少写空泛口号。
- 固定输出格式:表格、清单、模板字段越明确,结果越稳。
- 正文别太长:规范建议把详细参考拆到
references/,需要时再加载。 - 安全第一:安装别人的技能前,先审一遍附带脚本;陌生脚本不要盲目执行。官方也在规划更系统的安全指引。
如果你想做「固定模板写周报」,只要把 name、description 和正文改成周报结构(本周进展 / 风险 / 下周计划)即可,文件夹形态完全一样。
小结
Agent Skills 把「教会 AI 办某类事」收敛成可版本管理、可跨产品复用的文件夹标准。Anthropic 将其捐赠给 AAIF,是在 MCP 之后又一次把关键智能体基础设施交给中立治理;同一天 AAIF 还纳入 Open Responses、OpenEnv、OpenSandbox,开放智能体栈又厚了一层。
对普通人最友好的入门方式,不是先啃完整规范,而是:今天就写一个只含 SKILL.md 的小技能,让 AI 按你的格式整理会议纪要或周报。标准会继续演进,但「文件夹 + 说明书」这个起点,已经足够开始用了。
参考来源
- https://www.anthropic.com/news/donating-agent-skills-to-the-agentic-ai-foundation
- https://www.linuxfoundation.org/press/agentic-ai-foundation-announces-four-new-projects-agent-skills-open-responses-openenv-and-opensandbox
- https://agentskills.io
- https://agentskills.io/specification.md
- https://agentskills.io/skill-creation/quickstart.md
- https://simonwillison.net/2026/Oct/22/donating-agent-skills/


发表评论