Skill的格式 开发语言和工具文章目录Skill的格式 开发语言和工具1. Skill格式介绍1.1 目录结构规范各目录说明1.2 SKILL.md 文件规范必需元数据文件开头必须包含以下两个字段指令正文1.3 可选目录1.4 设计原则1.5 Agent Skills 是如何工作的三阶段工作流程2. 开发语言与工具开发步骤3. Codex 的安装4. Skill 的实战推荐看这篇博客之前把 VS Code 和 Codex 安装一下。Skill 的开发和使用需要使用这两个软件。1. Skill格式介绍什么是 Skill 关于 Skill 的基础认知介绍你可以看我这篇博客什么是Skill1.1 目录结构规范Skill本质上是一个文件夹核心是包含一个SKILL.md文件。这个文件包含元数据name和description是必须的以及指导 Agent执行特定任务的指令。目录结构的规范更详细的介绍可以看这个网站上的。参考: What are skills? - Agent Skillsmy‑skill/ ├── SKILL.md # 必需指令 元数据 ├── scripts/ # 可选可执行代码 ├── references/ # 可选参考文档 └── assets/ # 可选模板、资源文件一个 Skill.md 的完整内容可以看看这个至于这个 SKill 是干什么的你可以先不用管。各目录说明目录必需性用途SKILL.md必需包含YAML元数据名称、描述等和Markdown格式的详细指令scripts/可选存放可执行的脚本代码Skill可以调用这些脚本完成任务references/可选存放参考文档、补充说明材料assets/可选存放模板、图片、配置等资源文件所以如果要开发一个 Skill 你不会编程语言也是可以的只需要你能够使用 markdown语法编写必须的Skill.md文件就可以。只不过如果你要编写一个功能更加强大更加丰富的 Skill就需要结合编程语言去写脚本了。这种目录结构的优势文档化直接阅读SKILL.md就能理解 Skill 的功能可扩展性从简单的文本指令到复杂的可执行代码都能支持比如你想实现的 Skill写好了 Skill.md 这个文件但是没有达到效果然后你就添加脚本代码完善 SKill 的功能开始是纯文本后续可以添加脚本代码这就是可扩展性的体现可移植性纯文件形式易于编辑、版本控制和分享1.2 SKILL.md 文件规范这是每个 Skill 唯一必需的文件必须放在技能文件夹的根目录下。它采用YAML 前置元数据 Markdown 指令的格式。--- name: pdf-processing description: Extract PDF text, fill forms, merge files. Use when handling PDFs. --- # PDF Processing ## When to use this skill Use this skill when the user needs to work with PDF files... ## How to extract text 1. Use pdfplumber for text extraction... ## How to fill forms ...必需元数据文件开头必须包含以下两个字段name技能的简短标识符。description描述技能的功能及使用场景。Agent 在启动时只加载这个描述用于判断何时调用该技能。指令正文元数据之后使用 Markdown 编写详细的步骤、指南或提示告诉 Agent 如何完成任务。这部分内容仅在技能被激活时加载。无严格的结构限制可以包含任意 Markdown 内容。建议包含清晰的任务分解、步骤说明、代码示例等。这一段就是指令正文# PDF Processing ## When to use this skill Use this skill when the user needs to work with PDF files... ## How to extract text 1. Use pdfplumber for text extraction... ## How to fill forms ...1.3 可选目录可以回顾一下一个 Skill 需要的文件和目录目录必需性用途SKILL.md必需包含YAML元数据名称、描述等和Markdown格式的详细指令scripts/可选存放可执行的脚本代码Skill可以调用这些脚本完成任务references/可选存放参考文档、补充说明材料assets/可选存放模板、图片、配置等资源文件为了保持结构清晰扩展资源应放在以下子目录中scripts/存放可执行的脚本如 Python、Bash 文件。Agent 可在执行任务时运行它们。references/存放参考文档或额外信息如 API 文档、详细说明供 Agent 按需读取。假如你要设计一个问答QA的 SKill这里存放的就是 一个知识库这个 Skill 在回答问题的时候可以读取这个知识库中的文档匹配对应的文档assets/存放模板、图片、样式文件等静态资源用于生成输出或辅助工作流。假如你要设计一个bug分析报告一键生成的 Skill你可以写一个报告的模板存放在这个文件夹后续 Agent调用这个Skill 输出结果的时候就会按照你设计好的报告模板进行输出。1.4 设计原则这个规范遵循渐进式披露机制以高效管理上下文下面的设计原则我会使用 图书馆找书 这么个例子让你结合着进行理解。发现阶段启动时Agent 只加载所有 Skill 的name和description用于判断是否可能相关进入图书馆你不会盲目的招书比如你想学 Agent 相关的你就会看书名或者书架上的分类是计算机的且是关于 Agent 的书你才拿走这本书进行观看激活阶段当任务匹配某个技能描述时Agent 加载完整的SKILL.md指令。找到你符合的书之后你打开书本翻看目录检查是否是符合你的要求的执行阶段Agent 按照指令执行任务按需引用其他文件或执行打包的代码。查看目录之后确定有你想要学习的内容你就打开这本书对应的目录所在页数进行详细的学习。1.5 Agent Skills 是如何工作的Agent 并不会一次性把所有 Skill 的全部内容都加载进上下文而是采用逐步披露progressive disclosure的三阶段机制来加载和使用技能兼顾多技能储备与上下文开销。三阶段工作流程发现DiscoveryAgent 启动时仅读取每个 Skill 的name和description元数据。 只拿到最精简的基础信息用来判断当前用户的问题是否有可能命中该技能。完整的指令、脚本、参考文档此时并不会载入上下文。激活Activation当用户任务和某个 Skill 的描述匹配上Agent 判定该技能需要参与处理才会把完整的SKILL.md全部指令读取注入会话上下文。执行ExecutionAgent 按照SKILL.md中的指令开展工作按需调用scripts/下的可执行代码读取references/参考文档、assets/资源模板完成业务任务。这里指的Agent不仅仅指代 OpenClaw还可以是 Codex 等这类 Agent工具。2. 开发语言与工具开发一个 Skill本质上就是写一个说明书SKILL.md 准备一套工具 (scripts, 可选脚本)所以对编程语言没有硬性限制。目前最常用的开发语言有三类语言适用场景典型 Skill 示例开发工具推荐Python数据处理、AI 模型调用、文件处理、自动化脚本PDF 处理、数据分析、图像识别VS Code / PyCharmJavaScriptNode.js网页操作、浏览器自动化、Web API 调用Playwright 网页抓取、API 集成VS Code / WebStormBash / Shell系统命令、文件操作、环境配置系统管理、批量处理、部署脚本Terminal / iTerm2核心原则Skill 的SKILL.md是用 Markdown 写的纯文本而scripts/文件夹里的代码才涉及具体编程语言。所以即使你不会编程也能写 Skill—— 你可以只写 Markdown 指令让 Agent 自己去执行。开发步骤写 SKILL.md用 VS Code 打开文件夹新建SKILL.md填写元数据和指令写脚本在scripts/下写compress.py实现压缩逻辑本地测试在 VS Code终端 运行python scripts/XXX.py确保脚本没问题运行 SkillSkill 的运行我使用 Codex 来运行当然其他的 Agent 工具例如 OpenClaw 也是可以运行 Skill只不过我没有安装 OpenClaw 。VS Code 的安装网上有很多教程这个的安装很容易难的是 Codex。3. Codex 的安装至于 Codex 的下载和配置网上有教程这里我就不演示了。我给你我使用的安装教程复制下面的链接打开抖音抖音极速版6.15 03/03 bN.wF :4pm pQK:/ 复制打开抖音极速版看看【林粒粒呀的作品】小白速通 Codex 安装 国产大模型接入 #... https://v.douyin.com/64MU263FjHc/如果是需要魔法上网的话可以上 Github 找教程。4. Skill 的实战关于 Skill 的实战我有三个例子天气的获取Skill实战天气的获取二维码生成Skill实战二维码生成每日日报Skill实战需求文档自动生成测试点