基本用法Agent skill是给大模型看的说明文档那agent是从哪个文件夹读取skill文档呢以cursor为例cursor会从如下目录中加载skill文档位置作用域.agents/skills/.cursor/skills/项目级~/.agents/skills/~/.cursor/skills/用户级 (全局).claude/skills/.codex/skills/~/.claude/skills/~/.codex/skills/为了兼容cursor还会从claude和codex目录加载skill每个skill为一个包含SKILL.md文件的文件夹文件夹的名字则是skill的名字.agents/ └── skills/ └── my-skill/ └── SKILL.md技能还可以包含脚本、参考文件和资源等可选目录这个我们后面会介绍.agents/ └── skills/ └── deploy-app/ ├── SKILL.md ├── scripts/ │ ├── deploy.sh │ └── validate.py ├── references/ │ └── REFERENCE.md └── assets/ └── config-template.jsonskill的执行流程如下图所示我们写一个简单的skill用来统计一段文本中出现的人物目录结构如下.claude └── skills └── count ├── references │ └── info.md ├── scripts │ └── save.py └── SKILL.mdSKILL.md---name:countdescription:统计出现的人数---# 统计出现的人数## 简介根据文本统计出现的人数 如果需要获取人物的年龄信息则读取本目录下references/info.md文件 如果需要保存则执行本目录下的scripts/save.py python python3 save.py 要保存的内容 ## 示例输入 小红和小明出去玩了 输出 总共出现了2个人分别为小红小明 如果需要输出人物的年龄信息则输出如下 总共出现了2个人分别为小红小明|名字|信息||------|------||小红|18岁||小明|20岁|可以看到agent加载了需要的skill并进行了应用当然我们可以直接指定需要的skill/skill的名字再加上用户的输入即可高级用法referencesinfo.md# 个人信息|物品|价格||-----|-----||小红|18岁||小明|20岁||小白|20岁|可以按需读取参考文档如下图加载了info.md并输出了人物的年龄信息scriptssave.pyimportsysdefmain():contentsys.argv[1]print( 要保存的内容为)print(content)if__name____main__:main()还可以执行特定的脚本这个脚本简单打印了一下要保存的内容就不实际进行保存操作了渐进式披露原则agent并不会把一开始就把skill的所有内容都传给大模型而是按需加载mcp 和 agent skill 的区别技术作用mcp给大模型提供数据Agent skill教大模型如何处理数据skill不用我们自己写也行可以描述内容让大模型自己生成。我们也可以安装别人写好的skill