文章目录 1. Agent Skills 到底是什么Agent Skills 就是 用生活理解 2. Skills 到底有啥用 案例一让智能体不再“只会说你好” 案例二让智能体找到“工作” 3. Skills 的“专业套装”四个神秘文件 3.1 SKILL.md 是什么️ 它长这样 3.2 references/ 是什么 为什么要单独放 3.3 scripts/ 是什么 脚本干啥用 3.4 assets/ 是什么️ 资产干啥用 4. 四件套配合起来的样子‍♂️ 执行过程四件套总结️ 5. 实践手把手教你用 Skills新建SKILL.md文件效果 1. Agent Skills 到底是什么Agent Skills 智能体的“我会的技能”或者“拿手好戏”想象一下你去面试面试官“你会什么” 你“我会写代码、会讲笑话、会哄老板开心” 面试官“不错不错这些都是你的 skills”Agent Skills 就是角色Skills 对他们来说是普通用户让 AI 变能干的魔法博主可以分享的提示词清单开发者可以写的功能代码 文件夹结构智能体自己吃饭的本事你看完后哦原来这么简单Agent Skills 就是智能体的“我会啥”清单Skills 越多智能体越能干就像你会的技能越多工资越高一样 用生活理解你是谁你的 SkillsAgent 的 Skills厨师会炒菜、会切菜、会颠勺会查天气、会订票程序员会写代码、会修电脑会算数学、会翻译官方说法Agent Skills 是智能体可以执行的具体功能模块。人话版就是智能体的“我会干啥”清单 2. Skills 到底有啥用 案例一让智能体不再“只会说你好”没有 Skills 的智能体你“帮我查下明天天气” 智能体“什么是天气” 你“那帮我订个机票” 智能体“什么是机票” 你“……那你到底会啥” 智能体“我会说你好” 你卸载有 Skills 的智能体你“帮我查下明天天气” 智能体翻自己的 Skills“我有【查天气】技能调用中……” 智能体“明天晴天25℃” 你“顺便订个去北京的机票” 智能体继续翻“我有【订机票】技能马上安排” 你“太棒了” 案例二让智能体找到“工作”智能体去面试面试官“你有什么 skills” 智能体A“我……我只会说你好” 面试官“下一个” 智能体B掏出 Skills 清单 ✅ 查天气 ✅ 订机票 ✅ 算数学 ✅ 讲笑话 ✅ 写代码 面试官“就你了明天来上班” 3. Skills 的“专业套装”四个神秘文件如果你打开一个真正专业的 Skill会发现它不止是一段提示词而是一个文件夹里面住着四个神秘小伙伴my-skill/ ← 技能文件夹技能的名字 ├── SKILL.md ← 菜谱必填怎么做的说明书 ├── references/ ← 参考书可选背景知识、API文档 ├── scripts/ 厨具可选能跑的代码 └── assets/ ️ 摆盘可选模板、图片、字体 3.1 SKILL.md 是什么SKILL.md 技能的“总指挥”或者“使用说明书”它是整个技能的核心入口告诉智能体你是谁元数据什么时候该用你触发条件具体怎么干活操作步骤️ 它长这样--- name: weather-skill description: 查天气用这个技能支持国内城市 --- # 天气查询技能 ## 什么时候用 用户问天气时比如“北京天气怎么样” ## 怎么用 1. 提取城市名 2. 调用 scripts/weather.py 脚本 3. 把结果返回给用户 ## 注意事项 - 城市名要转成拼音 - 网络不通时返回友好提示人话版SKILL.md 就是技能的工作手册告诉AI“你该干啥、怎么干” 。 3.2 references/ 是什么references/ 技能的“图书馆”或者“参考资料室”里面放的是大段的知识文档比如API 接口文档公司内部规范产品设计指南常见问题解答references/ ├── api-docs.md ← API接口说明 ├── style-guide.md ← 设计规范 ├── troubleshooting.md ← 常见问题 └── city-code-conversion.md ← 城市代码转换表 为什么要单独放因为这些东西太长了如果全塞进 SKILL.mdAI 会被撑死Token爆炸聪明做法SKILL.md 只写“用哪个参考文件”需要的时候再去 references/ 里读具体内容这叫「渐进式加载」—— 用多少、读多少不浪费 。人话版references/ 就是技能的书架书很多但不全打开需要哪本拿哪本。 3.3 scripts/ 是什么scripts/ 技能的“手脚”或者“自动机器”里面放的是真正能跑的代码比如Python 脚本爬数据、算数学Shell 脚本操作文件、调用API任何可执行程序scripts/ ├── weather.py ← 真的去查天气的代码 ├── parse_pdf.py ← 解析PDF的代码 ├── send_email.sh ← 发邮件的脚本 └── calculate_price.js ← 算价格的代码 脚本干啥用有些事光靠AI脑子想不出来比如调用外部 API查天气、订机票操作本地文件读PDF、改图片跑复杂计算算圆周率这时候就要scripts/出马更厉害的是脚本跑的时候不占AI的脑子不消耗Token跑完把结果告诉AI就行 。人话版scripts/ 就是技能的手和脚AI脑子想好了手脚去干 3.4 assets/ 是什么assets/ 技能的“工具箱”或者“素材库”里面放的是成品模板和资源文件比如PPT模板生成周报用公司Logo做海报用字体文件写文章用示例代码参考用图片图标美化用assets/ ├── logo.png ← 公司logo ├── weekly-report.pptx ← 周报模板 ├── font.ttf ← 特殊字体 ├── example.html ← 示例代码 └── weather-icons/ ← 各种天气图标 ├── sunny.png ├── rainy.png └── cloudy.png️ 资产干啥用当AI要生成具体东西时直接拿 assets/ 里的现成模板用比如用户说“做个公司介绍PPT”AI打开 SKILL.md 看怎么做从 assets/ 里拿出 weekly-report.pptx填上内容 → 搞定人话版assets/ 就是技能的现成材料不用现做拿来就用 。 4. 四件套配合起来的样子用查天气技能举例这四个小伙伴怎么一起干活weather-skill/ ├── SKILL.md ← 告诉AI用户问天气时用这个流程 ├── references/ │ └── city-codes.md ← 城市代码对照表北京→101010100 ├── scripts/ │ └── weather.py ← 真的去高德地图API查天气的代码 └── assets/ └── icons/ ← 天气图标 ├── sunny.png └── rainy.png‍♂️ 执行过程用户“北京天气怎么样” SKILL.md“查天气要用 scripts/weather.py城市代码在 references/city-codes.md 里” references/city-codes.md“北京→101010100” scripts/weather.py 跑起来 - 拿着城市代码 101010100 - 调用高德地图API - 返回“北京 25℃晴” assets/icons/sunny.png☀️ AI“北京今天晴天25℃适合出去玩☀️”完美配合每个小伙伴干自己最擅长的事四件套总结组件是什么人话版必填吗SKILL.md技能说明书“怎么干活的流程”✅ 必填references/参考文档“背景知识图书馆”❌ 可选scripts/可执行代码“真干活的手脚”❌ 可选assets/模板资源“现成的材料”❌ 可选️ 5. 实践手把手教你用 Skills新建SKILL.md文件基础模版基本是这样--- name: my-first-skill description: 我的第一个技能 version: 1.0.0 --- # 我的第一个技能 ## 什么时候用 用户说 [触发词] 的时候 ## 怎么用 1. 提取用户输入中的 [关键信息] 2. 调用 scripts/demo.py 处理 3. 返回结果 ## 输入格式 用户应该说“帮我做 [事情]” ## 输出格式 “好的已经帮你做好 [事情] 啦” ## 注意事项 - 如果缺少 [关键信息]引导用户补充写一个测试一下大家可以直接复制## 模板字段说明 | 字段 | 必填 | 说明 | | :--- | :--- | :--- | | name | ✅ | 技能的唯一标识符用英文小写和连字符 | | version | ✅ | 语义化版本号 (SemVer) | | description | ✅ | 一句话说明 | --- name: skill-library description: 常用技能库 version: 1.1.0 author: feichen last_updated: 2026-03-06 --- # 技能库 (Skill Library) --- ## 写日报 **触发词**: 日报、写日报、帮我写日报 **输出格式**: 【今日工作】 1. [任务 1] 2. [任务 2] 【明日计划】 1. [计划 1] 【遇到的问题】 - [问题 1] **示例**: 用户帮我写日报 AI你今天做了哪些工作 用户写了 3 个页面修复了 2 个 bug AI: 【今日工作】 1. 完成 3 个页面开发 2. 修复 2 个 bug 【明日计划】 请补充 【遇到的问题】 请补充 --- ## 项目管理 **触发词**: 项目进度、项目计划、任务分配、里程碑 **输出模板**: 【项目名称】[名称] 【整体进度】XX% ✅ 已完成: [任务列表] 进行中: [任务列表] ⏳ 待开始: [任务列表] ⚠️ 风险: [风险描述] --- ## 代码审查 **触发词**: 代码审查、review 代码、代码优化 **审查要点**: - ✅ 代码质量命名、复用、注释 - ⚡ 性能循环、缓存、查询优化 - 安全SQL 注入、XSS、权限 - ❗ 错误处理异常捕获、日志 **输出模板**: 【代码审查报告】 文件[文件名] ✅ 优点[列出优点] ⚠️ 改进[问题 建议] 建议[优化方案] --- ## UI/UX设计 **触发词**: 设计页面、UI 优化、用户体验、配色 **设计原则**: - 视觉层次清晰 - 色彩搭配协调 (60-30-10 法则) - 交互反馈及时 (100ms) **检查清单**: - ✅ 布局合理、响应式完善 - ✅ 对比度达标、可读性好 - ✅ 按钮状态完整 (hover/active/disabled) --- ## 数据分析 **触发词**: 分析数据、数据可视化、趋势分析、转化率 **核心指标**: - 业务DAU/MAU、留存率、转化率、ARPU - 技术响应时间、错误率、可用性、QPS **输出模板**: 【数据分析报告】 周期[日期范围] 核心发现[1/2/3] 数据表现[关键指标] ⚠️ 异常[问题 原因] 建议[行动方案] (注意到时候手动去掉前面的符号因为不加这里样式会乱所以我手动加上的效果使用claude试一下效果回答的符合我设定的方式。注claude教程可以看上一篇《Claude Code 保姆级教程手把手教你白嫖最强AI编程助手》您好我是肥晨。欢迎关注我获取前端学习资源日常分享技术变革生存法则行业内幕洞察先机。