AI Agent:Skills的使用
文章目录
- 一、介绍
- 1.一句话介绍
- 2.定义
- 3.组成 (文件结构)
- (1)SKILL.md
- 4.核心要素
- 5.skills与prompt的区别
- 二、安装skills
- 1.skills的网址
- 2.推荐的常用skills
- 3.skill的安装命令
- 4.skills被安装的本地全局位置
一、介绍
1.一句话介绍
skills:技能,给Agent用的技能
把可复用的流程封装为可调用的能力。
Skills不是简单的提示词(Prompt),而是封装了完整工作流程的能力包。你可以把它想象成给AI准备的"工作手册"或"SOP标准操作程序"。
skills本质上就是一个文档,用于存放一些特定任务或场景下的AI行为规范。然后AI会自动读取这个文档并按照所规定的去执行。它强化的是AI在某个特定任务下的技能。
skills的价值在于复用
2.定义
Skills 是一组被写入本地文件的可执行指令与资源,帮助模型在特定场景下稳定输出。
- 将知识、流程、模板沉淀为固定入口
- 提供可重复的操作步骤与工具调用规范
- 可随项目更新、版本化与共享
3.组成 (文件结构)
一个完整的Skill通常包含以下组件:
- SKILL.md:必须的核心文件,包含YAML元数据和Markdown主体,定义Skill的基本信息和工作流程 【明确任务范围与触发规则;规定工具与步骤顺序】
- references.md:可选目录,存放按需加载的参考文档和示例
- scripts/:可选目录,存放可执行脚本(Python/Bash等),自动化脚本与转换工具;保证产出一致性
- assets/templates:可选目录,存放模板、图标等资源文件【复用模板、清单、素材;减少重复生成】
- examples.md:示例
(1)SKILL.md
skills的核心文件是SKILL.md。
它的结构固定地分为两部分:
1.头部
包含着name和描述字段。(这是agent用来识别skill的名片)
2.markdown主体
包含着详细的工作流程、输出格式要求、实例
其中最重要的部分是description描述字段:简要描述该技能的功能以及何时该使用它
举例:
anthropics/skills/PDF
--- name: pdf description: Use this skill whenever the user wants todoanything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs tomakethem searchable. If the user mentions a .pdffileor asks to produce one, use this skill. license: Proprietary. LICENSE.txt has complete terms ---4.核心要素
- 结构化知识:将特定任务的领域知识、操作流程、工具调用逻辑整合在一起
- 持久化能力:与一次性提示词不同,Skills是持久存在的能力模块,可反复调用
- 按需加载:采用"渐进式披露"(progressive disclosure)设计:先加载元信息判断适用性,再按需读取完整内容。
先让你看这个目录,再看这个章节,最后放这个附录。
skill的元信息先加载一小段,让模型知道有这么个手册,适用范围是什么;当模型判断这次任务真的用得上的时候,再把完整的SKILL.md读进它的上下文里。用这样的方式,不仅可以保证Agent能准确执行任务,还可以在长轮的对话中省下大量的Token。
5.skills与prompt的区别
prompt是临时性指令,天然适合一次性对话。但是当你关闭对话框时,模型也就忘记了你之前说过的话。 (优化:提炼每个对话,形成用户独特的长期记忆)
而skills是agent的长期记忆。 (AI agent可以理解为一个理解能力很强,很聪明的实习生,但是他不懂你司的规矩。而skills就是你们公司的SOP。)
二、安装skills
1.skills的网址
github上,Anthropics提供了一些skills:https://github.com/anthropics/skills/tree/main/skills
2.推荐的常用skills
1.PDF:pdf
2.PPT:pptx
3.Word:docx
4.生成skills:skill-creator
3.skill的安装命令
skill-installer 网址4.skills被安装的本地全局位置
C:\Users\用户名.codex\skills
PDF:C:\Users\用户名.codex\skills\pdf
PPT:C:\Users\用户名.codex\skills\pptx
Word:C:\Users\用户名.codex\skills\docx
