SKILLS开发

SKILL文件构成skill本质就是一个文件夹常见结构如下skill-name/ ├── SKILL.md ├── agents/ │ └── openai.yaml ├── scripts/ ├── references/ └── assets/SKILL.md必须有是核心文件是skill的说明书主要功能1.skill的功能2.AI触发了以后该怎么做。可以理解为是一个入口文件。agents/openai.yaml这是和界面展示相关的配置文件通常也需要。主要功能1.Skill 在界面里显示的名字2.简短介绍3.图标颜色等展示信息。scripts主要存放可执行脚本适合放那些需要精确执行的步骤例如Python脚本、shell脚本、JavaScript脚本等。例如PDF旋转、数据清洗、固定格式转换这类写成脚本比使用文字指令更有效。references主要存放参考资料比如表结构说明、接口文档、输出规范、业务规则、示例说明。这些内容不是每次都需要使用但是在某些步骤又特别好用所以专门使用references来存放而不是全部堆在SKILL.md里面。assets这里存放输出所用的素材比如logo、模版文件、示例表格、固定图片、字体、样式资源等。这些内容不是让模型读懂的是让模型直接拿来使用的内容。总结skill主要分为两层触发层和执行层触发层是告诉AI什么时候调用SKILL用户说什么类型的话时执行SKILL执行层就是告诉AI怎么做触发以后的流程是什么样的是否运行脚本输出格式什么样SKILL.md文件SKILL.md主要分为两大部分YAML frontmatter和Markdown正文结构如下--- name: your-skill-name description: describe what the skill does and when it should be used --- # Overview 这里写技能的核心作用和执行说明 ## Workflow 这里写步骤 ## Resources 这里写参考文件或脚本怎么用 ## Output Requirements 这里写输出要求在YAML部分主要有两个关键字段name和descriptionname是skill的名称要求小写、简短、用连字符连接单词、不要把skill这个词放进名字里。例如meeting-summary、official-document-draftingdescription是触发的依旧主要描述这个skill该做什么、什么时候使用。例如description: summarize meeting notes into structured decisions, action items, and follow-ups. use when the user provides raw meeting content, transcripts, or notes and wants a clean, organized summary.description应该尽可能详细二不能太泛太简单Markdown部分就是正文正文不是用来决定“是否触发”的主要是用来规定“触发之后怎么干”。开头首先说明skill的任务重点如下所示# Overview Turn messy meeting notes into a structured summary. Identify decisions, action items, open questions, and risks. Keep the output concise and scannable.