【Skills 系统从入门到精通】第 4 篇agentskills.io 开放标准——Skills 生态的跨平台愿景本篇你将学到agentskills.io 开放标准的定义、目标和技术规范SKILL.md 作为跨平台通用技能描述格式的设计理念不同 AI Agent 框架如何实现技能互通开放标准对 AI Agent 生态的深远意义如何参与开放生态编写兼容标准技能、发布和共享读完本篇你将理解 Skills 不是一个封闭在单一框架内的功能而是一个面向整个 AI Agent 生态的开放标准。一、为什么需要开放标准1.1 AI Agent 框架的碎片化现状当前的 AI Agent 领域百花齐放主流框架包括框架开发者定位Hermes AgentNous Research多平台 AI Agent支持 20 LLM 提供商Claude CodeAnthropic编码导向的 AI AgentCodex CLIOpenAI终端编程助手OpenClaw社区个人 AI 助手CursorAnysphereIDE 内 AI 编程WindsurfCodeiumIDE 内 AI 编程各类自研框架企业/研究机构定制化 Agent每个框架都有自己的能力扩展机制——有的叫插件有的叫扩展有的叫工具包。一个开发者在 Hermes 中写了一套优秀的运维操作流程如果想在 Claude Code 中也能使用往往需要完全重写。这种碎片化带来三个问题问题一重复劳动同一个操作流程比如 Kubernetes 部署步骤、数据库迁移流程在不同框架中各写一遍。内容大同小异但格式、接口、调用方式完全不同。问题二生态割裂每个框架的技能商店或插件市场都是独立的。用户切换框架后之前积累的技能无法迁移形成了迁移成本和锁定效应。问题三质量参差没有跨框架的技能共享机制意味着每个框架的社区都在独立解决相同的问题。优质技能无法被广泛复用低质量技能也没有横向比较的标准。1.2 开放标准的价值agentskills.io 开放标准正是为解决这些问题而生的。它的核心目标可以用一句话概括让一份技能文档在任何支持该标准的 AI Agent 框架中都能运行。这类似于 Web 标准对浏览器的意义。HTML/CSS/JS 是开放标准任何人编写的网页在任何遵循标准的浏览器中都能正确显示。同样遵循 agentskills.io 标准编写的 SKILL.md在任何兼容的 Agent 框架中都能被发现、加载和执行。开放标准带来的核心价值价值说明一次编写多平台运行一份 SKILL.md 可以在 Hermes、Claude Code、Codex 等框架中使用生态互通不同框架的用户社区可以共享技能降低锁定成本用户切换框架时技能库可以随人迁移标准化质量统一的格式规范使得技能质量可比较、可评估促进创新框架开发者专注于核心能力技能内容由社区共建碎片化现状每个框架独立一套遵循遵循遵循遵循Hermes 扩展机制Claude Code 插件Codex CLI 工具包自研框架 定制机制agentskills.io 开放标准SKILL.md 通用格式一次编写 多平台运行二、SKILL.md跨平台的技能通用语言2.1 为什么选择 Markdownagentskills.io 标准选择 Markdown 作为技能文档的格式这个选择不是随意的。Markdown 兼具人类可读性和机器可解析性人类可读Markdown 是纯文本任何人不需要专用工具就能阅读和编辑。技术文档、博客文章、README 文件广泛使用 Markdown开发者对它非常熟悉。机器可解析通过 YAML Frontmatter三横线之间的元数据块 Markdown Body正文的结构程序可以轻松提取元数据和内容。YAML Frontmatter 提供结构化的元数据字段Markdown Body 提供灵活的指令内容。版本控制友好作为纯文本Markdown 文件天然适配 Git 等版本控制系统。技能的每次修改都能 diff、merge、review就像管理代码一样管理知识。无运行时依赖一个.md文件不需要编译、不需要安装依赖、不需要特定运行时环境。复制即安装删除即卸载。2.2 SKILL.md 的标准结构一个符合 agentskills.io 标准的 SKILL.md 文件包含两部分第一部分YAML Frontmatter元数据位于文件开头用三横线---包裹。包含技能的标识信息和配置---name:my-skill# 技能名称必填description:Brief description# 触发描述必填version:1.0.0# 版本号推荐metadata:# 扩展元数据tags:[python,automation]# 标签---第二部分Markdown Body指令内容Frontmatter 之后的全部内容是 Agent 阅读的指令文档# My Skill ## When to Use - 触发条件 ## Procedure 1. 操作步骤 ## Pitfalls - 已知陷阱SKILL.md 通用格式Frontmatter 元数据块三横线包裹name 与 descriptionversion 版本机器读取解析Body 指令文档三横线之后When to UseProcedure 与 PitfallsAgent 阅读执行2.3 核心字段规范agentskills.io 标准规定了以下核心字段字段必填说明约束name是技能的唯一标识符小写字母连字符≤64字符description是触发描述Agent 据此判断是否加载≤1024字符建议以 “Use when…” 开头version否语义化版本号格式主版本.次版本.修订号platforms否支持的操作系统列表可选值macOS、Linux、Windows除了核心字段外不同框架可以定义自己的扩展字段。例如 Hermes 在metadata.hermes下定义了标签、分类、条件激活等扩展字段。这些扩展字段不影响跨平台兼容性——不识别扩展字段的框架会直接忽略它们。2.4 跨平台兼容性原则编写跨平台兼容的技能时需要遵循以下原则原则一核心字段保持标准name和description使用标准格式不添加任何框架特定的前缀或语法。原则二框架扩展放 metadata 下需要框架特定配置时放在metadata.框架名命名空间下。例如 Hermes 的扩展放在metadata.hermes下。metadata:hermes:# Hermes 扩展字段tags:[devops]category:devops原则三Body 内容使用通用工具命令正文中的操作步骤应尽量使用通用命令标准 shell 命令、标准 API 调用避免依赖某个框架特有的工具。原则四辅助文件使用标准目录辅助文件放在标准的references/、templates/、scripts/、assets/目录下。这些目录命名是跨框架通用的。三、跨框架技能互通实践3.1 技能的可移植性一份编写规范的 SKILL.md 具有高度的可移植性。以下是一个跨框架使用的示例场景编写了一个Git 仓库代码统计技能。---name:codebase-statsdescription:Use when analyzing codebase statistics. LOC,language breakdown,file counts.version:1.0.0metadata:hermes:tags:[github,analysis]---# 代码库统计## When to Use-需要了解代码库规模-评估重构前的代码量-生成项目报告## Procedure1. 使用 git log 统计提交历史 2. 使用 find wc 统计代码行数 3. 按文件类型分类统计 4. 生成摘要报告## Pitfalls-注意排除 vendor/ 和 node_modules/ 目录-二进制文件不计入代码行数这个技能可以在 Hermes 中通过/codebase-stats调用在 Claude Code 中作为技能加载在 Codex CLI 中作为上下文注入。由于正文使用的是通用的git和find命令任何具备终端执行能力的 Agent 都能执行。codebase-stats 技能标准 SKILL.mdHermes斜杠命令调用Claude Code作为技能加载Codex CLI作为上下文注入任何兼容框架通用 git find 命令3.2 框架特定差异的处理不同框架在工具集、接口格式上存在差异。处理这些差异的策略策略一正文使用通用描述具体调用由 Agent 适配不在技能正文中写死具体的工具调用语法而是描述操作意图。Agent 会根据自己可用的工具集来执行。好的写法步骤1读取项目根目录的文件列表 步骤2统计各类型文件的数量不理想的写法步骤1调用 terminal(ls -la /project/) 步骤2调用 terminal(find . -type f | sed s/.*\.// | sort | uniq -c)前一种写法让 Agent 自行选择合适的工具Hermes 用terminalClaude Code 可能用Bash后一种绑定了特定框架的工具名称。策略二条件分支处理差异如果操作步骤确实因框架而异可以在正文中使用条件分支步骤1执行 shell 命令 - 如果 terminal 工具可用直接执行 - 如果只有 Bash 工具通过 Bash 执行策略三将框架差异封装在脚本中如果操作逻辑复杂可以编写一个通用脚本放在scripts/目录下。正文只需写运行scripts/analyze.py各框架用各自的方式执行脚本。3.3 生态级互通Skills Hub除了手动复制 SKILL.md 文件外Skills Hub 提供了生态级的技能分发渠道开发者编写技能 │ ├──→ 发布到 GitHub 仓库Tap │ ├──→ 提交到 skills.sh 目录 │ └──→ 发布到 .well-known 端点 │ ↓ 任何兼容框架的用户都能搜索和安装这意味着一份优质技能可以同时服务于多个框架的用户社区。关于 Skills Hub 的详细使用将在第六模块深入讲解。四、开放标准对 AI Agent 生态的意义4.1 类比HTTP 之于互联网要理解 agentskills.io 标准的深远意义可以回顾互联网历史。在 HTTP 标准确立之前网络世界充斥着各种私有协议——AOL 有自己的拨号协议CompuServe 有自己的信息格式微软有 NetBIOS。用户被锁定在特定的服务商生态中跨服务商通信极其困难。HTTP 标准化后任何服务器都能与任何浏览器通信。Web 内容可以在任何设备上访问。这个开放标准催生了整个互联网生态——万维网、搜索引擎、电商、社交媒体。agentskills.io 对 AI Agent 生态的意义与此类似。它不是某个框架的功能特性而是一个让不同 Agent 框架能够共享知识层的通用协议。4.2 四个层面的影响层面一用户层面——技能资产可迁移用户在某个框架中积累的技能库不再是锁定在该框架内的资产。切换框架时技能库可以随人迁移。这大幅降低了用户的框架切换成本。层面二开发者层面——一次编写多平台受益技能开发者无论是个人还是团队只需要编写一份 SKILL.md就能让技能同时在多个框架中可用。创作效率倍增受众面也成倍扩大。层面三框架层面——聚焦核心能力框架开发者不需要为每个场景从头编写技能。框架本身专注于核心能力模型推理、工具调度、安全控制技能内容由社区生态提供。这就像操作系统不需要自己开发所有应用程序——应用程序由第三方生态提供。层面四行业层面——知识标准化不同团队、不同公司的运维流程、开发规范、最佳实践可以通过 SKILL.md 标准化表达和传播。这为 AI Agent 行业的知识共享提供了基础设施。4.3 开放标准 vs 封闭生态对比项开放标准agentskills.io封闭生态技能来源多框架社区共建单一框架内部技能数量跨社区汇聚增长快受限于一框架用户基数技能质量跨社区比较优胜劣汰缺乏横向比较用户迁移成本低技能可迁移高技能锁定创新速度快站在全行业肩膀上慢重复造轮子生态健康度多元化、抗风险单点依赖、脆弱4.4 开放标准的演进agentskills.io 是一个不断演进的标准。它的核心字段name、description是稳定的、向后兼容的。扩展字段允许各框架自行创新。标准的演进路径遵循一个成熟的模式阶段一 核心标准确立name descriptionMarkdown Body阶段二 扩展字段实践tags platforms条件激活阶段三 最佳实践沉淀成熟模式纳入核心标准阶段四 生态繁荣跨框架技能市场质量认证agentskills.io 标准演进路径当前整个生态正在从阶段二向阶段三过渡。越来越多的实践证明了条件激活、配置管理等扩展模式的价值这些模式有望在未来被纳入标准核心。五、如何参与开放生态5.1 编写兼容标准的技能参与开放生态的第一步是编写符合标准的技能。核心要点必填字段齐全name小写连字符和description“Use when…” 模式框架扩展放 metadata不污染核心字段正文用通用描述不绑定特定工具名辅助文件用标准目录references / templates / scripts / assets验证可移植性在不同框架中测试技能是否正常工作关于技能编写的完整指南将在第五模块第 20-24 篇详细讲解。5.2 发布和共享技能编写好技能后有三种发布渠道渠道一GitHub 仓库Tap创建一个 GitHub 仓库把技能放在skills/目录下。其他用户通过hermes skills tap add your-org/your-repo订阅安装。渠道二skills.sh 目录将技能提交到 skills.sh 公共目录由 Vercel 运营获得更广泛的曝光。其他框架的用户也能通过 skills.sh 发现你的技能。渠道三.well-known 端点如果你有个人网站或团队文档站可以在网站根目录下发布/.well-known/skills/index.json让用户通过网站 URL 直接发现和安装技能。关于发布的详细操作将在第七模块第 35 篇讲解。5.3 贡献社区除了编写和发布技能外还有多种方式参与社区贡献审查和反馈使用他人编写的技能时提供使用反馈、报告问题改进现有技能发现可优化的技能时提交改进建议或 patch编写教程和文档分享技能编写经验和最佳实践推广开放标准在自己的团队和社区中推广 agentskills.io 标准本篇小结知识点核心内容碎片化问题各 AI Agent 框架扩展机制不互通导致重复劳动、生态割裂、质量参差开放标准目标让一份技能文档在任何兼容框架中都能被发现、加载和执行SKILL.md 格式YAML Frontmatter元数据 Markdown Body指令内容核心字段跨平台通用核心字段name必填、description必填、version推荐、platforms可选跨平台兼容原则核心字段标准化、扩展放 metadata、正文用通用描述、辅助文件用标准目录开放标准价值一次编写多平台运行、技能资产可迁移、降低锁定、促进创新HTTP 类比开放标准之于 AI Agent HTTP 之于互联网——统一协议催生生态繁荣参与方式编写兼容标准技能、发布到 GitHub/skills.sh/.well-known、贡献社区第一模块总结至此第一模块概念入门的四篇全部完成。回顾第一模块的知识脉络第1篇Skills 是什么第2篇Agent 中的定位第3篇如何高效加载第4篇生态愿景通过这四篇你已经从宏观层面理解了 Skills 系统的全貌。接下来的第二模块将进入实战——教你如何在实际中使用 Skills。下篇预告从下一篇开始进入第二模块使用 Skills。第 5 篇将从零开始——安装 Hermes、查看技能列表、调用第一个技能并体验 Agent 的自我改进能力。理论部分到此告一段落接下来全是实战。如果本篇内容对你有帮助欢迎点赞收藏有任何疑问欢迎在评论区交流。