MCP重磅扩展ext-skills是什么?AI Agent技能随服务器一键分发的完整指南
MCP重磅扩展ext-skills是什么?AI Agent技能随服务器一键分发的完整指南
ext-skills 是 Model Context Protocol(MCP)官方的 Skills 扩展(io.modelcontextprotocol/skills)规范仓库,由 Skills Over MCP 工作组维护。它让 MCP 服务器可以把 AI Agent 技能(Skills) 作为标准资源随服务器一键分发:Agent 无需手动安装文件,连接服务器即可发现、校验并加载技能。
📌 一句话理解:工具随服务器走,用法说明书也随服务器走。
为什么需要 MCP Skills 扩展?
先回忆一个痛点:MCP 服务器为 AI Agent 提供工具(tools)、资源(resources)和提示词(prompts),但**"怎么把这些工具用好"的说明**通常挤在服务器 instructions 里,越写越长。于是出现了四类典型困境:
- 复杂工作流塞不进工具描述——多步骤、有条件分支的编排逻辑,远超 instructions 的容量;
- 技能分发割裂——服务器是一个仓库、技能是另一个仓库,用户要装两遍,版本还可能对不上;
- 跨服务器编排缺失——一个技能需要指挥多个 MCP 服务器的工具,本地文件技能无从挂载;
- 更新与校验无标准——技能升级后客户端无从感知,更无法验证内容未被篡改。
ext-skills 的解法很克制:不重新发明技能格式,只做"传输绑定"——技能本身遵循 Agent Skills 规范(一个含 SKILL.md 的目录),扩展只定义如何把它装进 MCP 的管道里。这样格式演进与传输协议各走各的,互不拖累。
核心工作原理:技能就是 Resources
ext-skills 最重要的设计决策是复用已有的 Resources 原语,而不是发明新原语。技能里的每个文件都是一个 MCP 资源,约定使用 skill:// URI 方案:
skill://<skill-path>/<file-path>
以 pdf-processing 技能为例,资源地址长这样:
| 技能路径 | 文件 | 资源 URI |
|---|---|---|
git-workflow |
SKILL.md |
skill://git-workflow/SKILL.md |
pdf-processing |
references/FORMS.md |
skill://pdf-processing/references/FORMS.md |
acme/billing/refunds |
examples/email.md |
skill://acme/billing/refunds/examples/email.md |
两个实用特性值得注意:
- 层级命名空间:
<skill-path>可以嵌套(如acme/billing/refunds),同一服务器上可以有多个都叫refunds的技能,靠前缀区分,互不冲突; - 末段即名字:路径最后一段必须等于
SKILL.mdfrontmatter 里的name字段,Agent 光看 URI 就知道技能叫什么,无需先读文件。
三个新方法:一键发现、获取与浏览技能
扩展在 MCP 上只引入三个方法,分工明确:
| 方法 | 作用 | 必选 |
|---|---|---|
skills/list |
列出服务器提供的全部技能(支持分页) | 必选 |
skills/get |
按 URI 获取单个技能的完整条目 | 必选 |
resources/directory/read |
读取目录资源下的一级子项(技能的"readdir") | 可选(需声明 directoryRead: true) |
一次完整的技能加载流程
规范中给出了教科书级的消息流示例,可以概括为四步:
- 发现:客户端调用
skills/list,拿到每个技能的 URI、frontmatter(名称与描述)以及逐文件的 SHA-256 摘要清单; - 审批:用户确认加载,审批绑定到当时的文件摘要集合(内容绑定审批);
- 读取:通过标准的
resources/read拉取SKILL.md及支撑文件,逐文件校验大小与摘要; - 按需浏览:技能里写"从
templates/选一个模板"时,Agent 用resources/directory/read逐级浏览目录,就像在本地文件系统中一样。
这个流程有个精妙之处:懒加载。连接时、列表时、审批时都不下载文件,SKILL.md 只在技能被加载时拉取,支撑文件在被读到时才拉取——技能目录可能有几千个条目,客户端却只为实际用到的内容付费。
安全设计:技能内容被视为不可信输入
技能是给模型的"说明文档",天然是一个提示注入面。ext-skills 为此规定了严格的安全底线(详见规范 Security Considerations 章节):
- 来源必须可见:技能内容进入模型上下文时,必须标注它来自哪个服务器,不能伪装成本地文件技能;
- 禁止隐式执行:MCP 下发的技能不能在没有用户逐技能审批的情况下触发主机侧代码执行;
- 内容绑定审批:一旦文件的摘要集合变化(换文件、加文件、删文件),旧审批自动作废,必须重新征求用户同意;
- 摘要不是信任锚:摘要只证明文件与清单一致,不证明文件可信——这一点规范写得非常坦诚;
- 缓存隔离:缓存的技能内容必须放在本地文件技能发现路径之外,且不能获得"本地技能"的信任级别。
这些规则把"连接了服务器"和"信任了技能内容"清晰地分开,是这套扩展能被生产环境采纳的关键。
生态进展:谁已经支持 ext-skills?
工作组在 docs/implementations.md 中维护了一份社区实现的清单,生态正在快速成形:
- 官方 SDK:Go、TypeScript、Python、C# 四大官方 SDK 均已开启 Skills 扩展支持,其中 Go SDK 已通过一致性测试套件;
- 服务器:Hugging Face 的
hf-mcp-server已按 v1 完整实现(含skills/list、skills/get与目录读取); - 客户端/宿主:官方 MCP Inspector 从 2.6.0 起支持该扩展并内置 CLI 技能校验,社区宿主如 mcpkit 提供了带摘要校验读取和按来源解析的
load_skill工具。
想持续跟踪支持进度,直接看 implementations 清单 即可。
仓库导读:去哪里读规范与设计文档
ext-skills 仓库本身就是一份很好的"协议工程"教材,推荐按这个顺序阅读:
| 文档 | 内容 | 适合人群 |
|---|---|---|
| specification/stable/skills.mdx | 扩展规范正文(事实来源),含完整消息流示例 | 所有读者 |
| docs/rationale.md | 设计 rationale:为什么用 Resources 而非新原语、为什么逐文件摘要 | 想了解"为什么这么设计" |
| docs/decisions.md | ADR 格式的决策日志,记录规范演进过程 | 协议设计者 |
| docs/implementations.md | 服务器、SDK、宿主实现矩阵 | 开发者 |
| docs/archive/ | 发布前的设计文档、实验发现、用例研究 | 想深挖历史与动机 |
| CONTRIBUTING.md | 参与贡献的流程 | 贡献者 |
例如"为什么允许 skills/list 返回空或部分列表"这类问题,在 rationale 文档 里能找到一段专门的解答:面向数千个 API 端点动态合成技能的文档服务器、网关型服务器,本就无法枚举完整目录——所以规范把"任何技能 URI 都可直接用 resources/read 读取"作为保底能力,列表只是增强。
常见问题(FAQ)
Q1:ext-skills 和我本地安装的 Agent Skills 是什么关系?
两者互补。本地文件技能照旧工作;ext-skills 增加了一条新通道——服务器把自己的技能随服务器一起分发。规范明确要求宿主不得让远程技能"静默遮蔽"同名本地技能。
Q2:技能文件会被偷偷换掉吗?
这正是逐文件 SHA-256 摘要 + 内容绑定审批要解决的问题:摘要集合一变,旧审批立即失效,宿主必须重新征求用户同意。
Q3:服务器可以不提供技能列表吗?
可以。列表允许为空或部分(规范明确支持),但"给定 URI 必须能读"是底线能力,配合 skills/get 任何技能都能单独拿到校验信息。
Q4:单个技能有大小限制吗?
有硬性上限:每个技能最多 512 个文件条目、总大小 16 MiB。宿主必须支持到上限,服务器不应提供超限技能。
总结
ext-skills 用最小的设计代价解决了技能分发这个真问题:
- 📦 一键分发——技能随服务器走,
skills/list即发现; - 🔗 复用原语——技能就是
skill://资源,客户端无需学新概念; - 🛡️ 安全内建——来源标注、内容绑定审批、缓存隔离,层层设防;
- 🌱 生态落地——四大官方 SDK 与 Hugging Face 等服务器已按 v1 实现。
如果你正在构建 MCP 服务器,现在就是最好的时机:把服务器和它的使用说明书打包成 Skills 一起交付,用户连接即学会。规范全文见 specification/stable/skills.mdx,欢迎从 CONTRIBUTING.md 开始参与贡献。
