夜雨聆风
给 AI 装“技能插件”?Skill 写法全攻略,小白也能看懂
你有没有发现，同样是 AI 助手，有些人用起来就像请了个全能助理，帮写代码、生成报告、自动发布；而有些人用了半天，感觉只是个升级版搜索引擎？
差距可能就在：Skill（技能）。
先说说，Skill 到底是个啥？
简单类比一下：你手机上的 App 就是功能，你给 AI 安装 Skill 就类似给手机装 App —— 装了美图 App，AI 就懂图片处理；装了公众号写作技能，AI 就变成了你的专职文案。
技术上说，Skill 就是一个文件夹，核心是一个叫 SKILL.md 的说明文档，里面写着“你能做什么、怎么做”，AI 读完这个文件，就学会了这项技能。
没有 Python 基础？没关系，Skill 本质上就是写给 AI 看的说明书，只要会打字就能上手。
Skill 长什么样？来看最小结构
一个 Skill 最简单的形态，只需要一个文件：
my-skill/
└── SKILL.md ← 就这一个文件，够了
当然，复杂一点的 Skill 可以扩展成这样：
my-skill/
├── SKILL.md ← 必须有（核心说明文件）├── scripts/ ← 可选（放Python脚本）├── references/← 可选（放参考资料）└── assets/ ← 可选（放模板、图片）
别被这个目录结构吓到，对于初学者来说，你只需要搞定 SKILL.md 这一个文件就好。
重头戏：SKILL.md 怎么写？
SKILL.md 分两部分：头部信息 + 正文指令。
第一部分：头部信息（YAML格式）
`yaml
name: my-first-skill
description: 当用户需要写周报时使用此技能，帮助生成结构化的工作周报。
这里最重要的两个字段：
| 字段 | 作用 | 示例 |
| name | 技能的唯一名称（小写+短横线） | weekly-report |
| description | 描述触发条件（这个超级重要！） | "当用户要写周报时使用" |
划重点：description 是 AI 判断"要不要启用这个技能"的依据。写得越清楚，技能触发越准。别写成"这个技能很好用"这种废话，要写"什么情况下用它"。
第二部分：正文指令（Markdown 格式）
头部信息之后，用普通的 Markdown 写出具体的操作指南：
`markdown
name: weekly-report
description: 当用户需要撰写工作周报、总结本周工作时使用。
使用说明
帮助用户生成结构清晰的工作周报。
周报格式规范
按以下结构生成周报：
本周完成事项
-
列出3-5项本周完成的具体工作
遇到的问题
-
描述遇到的挑战和解决方案
下周计划
-
列出下周的工作重点
注意事项
-
语言简洁专业，避免口水话
-
每项工作说明具体成果，不要只写"完成了XX"
-
如果用户没提供细节，主动追问
- 看到没？正文就是在教 AI 怎么做事，越具体越好，越像"操作手册"越好。
一个完整例子：从零写一个"自动总结会议纪要"的 Skill
考虑到上手门槛尽量低一些，我以腾讯的Workbuddy为例。
假设你经常要把录音或文字记录整理成会议纪要，我们来写一个专属技能。
第一步：创建文件夹在你的 WorkBuddy 技能目录（一般是
~/.workbuddy/skills/）下新建一个文件夹：`
meeting-summarizer/
└── SKILL.md
`第二步：写 SKILL.md`markdown
name: meeting-summarizer
description: 当用户需要整理会议记录、总结会议内容、生成会议纪要时使用此技能。
# 会议纪要助手
将用户提供的会议内容（录音文字、聊天记录、笔记）整理成规范的会议纪要。
输出格式
会议基本信息
-
会议日期：（从内容中提取或询问用户）
-
参会人员：（列出提到的相关人员）
-
会议主题：（一句话概括）
讨论要点
（按讨论顺序列出主要议题，每点2-3句话说明）
决策结论
（列出会议中明确的决定和方向）
待办事项
（列出 Action Items，包含负责人和截止时间）
操作规则
-
如果用户的输入信息不够，主动问"这次会议的主题是什么？"
-
敏感内容（如薪资、人事纠纷）打码处理，用 [已隐藏] 替代
-
输出完成后，询问用户是否需要调整
`第三步：重启 WorkBuddy，测试一下
直接对 AI 说："帮我整理一下这段会议记录……"，AI 就会自动调用这个技能了。
写好Skill的3个核心原则
说了这么多，给你总结三个最关键的点：
1. description 要写"触发条件"，不是功能介绍❌ 错误写法：
description: 这是一个很好用的会议技能✅ 正确写法：description: 当用户需要整理会议记录、生成会议纪要时使用2. 正文用"命令句"，把 AI 当下属使唤❌ 错误写法：可以帮助用户生成周报（这是给人看的介绍）✅ 正确写法：按以下格式生成周报……（这是给 AI 看的指令）3. 越具体越好，边界越清楚越好
与其写"帮用户写内容"，不如写"按照以下结构生成500字左右的内容，包含：标题、3个正文段落、结尾行动号召"。
Skill 文件放在哪里？
| 存放位置 | 生效范围 |
|
~/.workbuddy/skills/ | 全局生效，所有项目都能用 || 项目根目录/.workbuddy/skills/` | 仅当前项目生效 |
对于个人日常使用，一般放全局目录就够了。
去哪里找现成的 Skill？
不想从零写？完全可以先用别人的：
- WorkBuddy 内置市场
打开 WorkBuddy → 左侧菜单”专家/技能” → 直接搜索安装
- SkillHub 社区
[https://clawhub.ai/](https://clawhub.ai/) 有 2 万多个社区技能
- GitHub 搜索
搜索 “WorkBuddy Skill” 或 “SKILL.md”
⚠️ 小提醒：安装社区技能前，WorkBuddy 会自动做安全审查，遇到高风险提示最好看一眼再决定。
最后说两句
Skill 这个功能，说复杂也复杂，说简单也简单。
对于技术小白，你只需要记住：Skill = 一个文件夹 + 一个 SKILL.md 说明文档。说明文档里写清楚“什么时候用”（description）和“怎么用”（正文指令），AI 就学会了。
不需要写代码，不需要懂算法，就是写人话 —— 只不过这个“人话”是写给 AI 看的。
试着写一个你最常用场景的 Skill 吧，可能5分钟之后，你的 AI 就会比别人的聪明一大截。
阅读更多文章：
AI Agent研发思路猜想：是否可用Workflow给OpenClaw加上harness工程
同为AI操作系统，为什么OpenClaw备受吹捧，豆包手机却饱受诟病？
AI创作者、提示词工程师要哭了！上海首例判决：AI提示词不是作品，不可版权
《大模型的数据科学》PPT：复旦大学教授肖仰华在上海外滩大会上的演讲记录