🤖 1. Agent Skills 到底是什么？
Agent Skills = 智能体的 “我会的技能” 或者 “拿手好戏”！
想象一下你去面试：
面试官：“你会什么？”
你：“我会写代码、会讲笑话、会哄老板开心”
面试官：“不错不错，这些都是你的 skills”
Agent Skills 就是：
| 角色 | Skills 对他们来说是 |
|---|---|
| 普通用户 | 让 AI 变能干的魔法 |
| 博主 | 可以分享的提示词清单 |
| 开发者 | 可以写的功能代码 + 文件夹结构 |
| 智能体自己 | 吃饭的本事 |
| 你（看完后） | 哦！原来这么简单！ |
Agent Skills 就是智能体的“我会啥”清单！
Skills 越多，智能体越能干！就像你会的技能越多，工资越高一样！ 💰
🎭 用生活理解
| 你是谁 | 你的 Skills | Agent 的 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.md，AI 会被撑死（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编程助手》）
您好，我是肥晨。 欢迎关注我获取前端学习资源，日常分享技术变革，生存法则；行业内幕，洞察先机。
