本篇目标：搞懂技能（Skill）的本质与工作原理，学会安装和管理技能，掌握四种创建自定义技能的方法（重点是 skill-creator 和 SKILL.md），并把第五篇跑通的数据分析流程沉淀为你自己的第一个专属技能。
核心结论先记住：Skill 就是写给 AI 的"岗位说明书"——触发条件、执行步骤、输出格式都写在里面，从此一句话复用。

1 技能是什么：从"通用助手"到"领域专家"

1.1 一个类比彻底讲明白

把 WorkBuddy 想成一部智能手机：出厂自带操作系统和基础功能（对话、基础文件操作），这些是"内置能力"；你给它装 App，它才拥有剪辑视频、修图、点外卖的能力——技能就是 App。

更精确的官方定义：Skill 是封装脚本与标准化工作流的工具插件，在用户授权下，让 AI 完成读写文档、调用第三方 API、网页自动化、邮件发送、数据统计、文件转换等实体操作。

还有个"雇人"版类比：你雇了个特别聪明的助手，但他不知道你公司的规矩。你给他一份操作手册——"遇到这类问题，按这个流程走"——这份手册就是 Skill。

1.2 技能 vs 提示词：为什么说 Skill 更值钱

↔ 左右滑动查看完整表格
维度提示词Skill
生命周期临时，用一次就没了持久化文档，反复使用
可靠性每次都要重写，质量不稳定封装了流程+脚本+资产，输出稳定
可分享复制粘贴可打包分享、可版本化
价值教 AI 一次相当于把"高手经验"打包成可复用工具

Skill 解决的正是职场四大痛点：重复输入 Prompt、个人经验难传承、AI 输出质量不稳定、好工具无法团队共享。

1.3 技能的本质：一个文件夹 + 一份 SKILL.md

每个技能本质上是一个文件夹，核心是一份 SKILL.md 配置文件，写清四件事：这个技能叫什么、什么时候触发它、遇到任务按什么步骤做、输出什么格式。WorkBuddy 读到这个配置文件，就知道该怎么执行这类任务——一个技能就是一个"做事的配方"。

完整结构（可选部分按需添加）：

my-skill/
├── SKILL.md        ← 必需：YAML头 + Markdown 指令
├── references/     ← 可选：参考文档（schema、公司政策、API文档）
├── scripts/        ← 可选：辅助脚本（确定性执行的代码）
└── assets/         ← 可选：模板资产（品牌logo、PPT模板）

三种子目录的设计思路：同一段代码反复重写或需要确定性执行时放 scripts/；大量参考信息需要查阅但不想占满上下文时放 references/；产出物需要用模板/图片/字体时放 assets/。新手不要一开始就堆很多文件——只有任务确实需要批量处理、格式转换或自动计算时，才考虑加脚本。

1.4 存放位置：用户级 vs 项目级

  • 用户级：~/.workbuddy/skills/（全局，所有项目通用，装在你自己的账号下）
  • 项目级：{工作空间}/.workbuddy/skills/（跟随某个具体项目，团队成员共享，可放进 Git 版本库）

存储位置的隐蔽知识点：AI 自动生成配置保存到本地技能库时，会提醒"技能库位置跟工作空间不一致，一般会保存到 C 盘"，可以选择不同意更换位置——对应第三篇的存储路径规划。

1.5 技能在能力架构中的位置

WorkBuddy 的核心能力由三部分构成，分工明确：

  • 专家：具备人设、方法论与工具链的 AI 顾问——提供"思考视角"；
  • 技能：可安装启用的可执行脚本与工作流——提供"执行能力"，始终以你本人的身份执行操作；
  • 连接器：标准化外部服务对接通道（MCP/CLI），独立授权、不超出你已有权限——打通"外部数据通路"。

三者形成"思考+执行"的闭环。

2 技能从哪来：生态全景与安装方法

2.1 三大技能来源

  1. 官方内置：WorkBuddy 出厂自带 20-30 多个官方技能包，覆盖最常用办公场景，部分版本新用户还自动获得 10 款常用技能包（30 天有效期）；
  2. 社区生态：完全兼容 OpenClaw（小龙虾）技能生态，SkillHub 社区汇聚海量技能（不同资料口径为 1.3 万\~8 万个），数十个赛道：文档、金融、办公协同、数据分析、内容创作、开发工具、教育学习等；
  3. 自定义创建：把你自己跑通的流程沉淀为专属技能——这是本篇的主角。

2.2 四种安装方式

方式一：对话中直接安装（最简单，推荐）

直接对 WorkBuddy 说：

"帮我安装一个可以操作 Excel 的技能"
"find skill for stock"（英文同样有效）

它会自动调用 marketplace-skill-installer 从推荐市场搜索并安装，全程约 30 秒。也可以先搜后装："查找技能 PDF""有哪些可用的技能？"——它会列出所有可用技能并推荐。

方式二：技能市场（SkillHub）图形化安装

  1. 打开左侧菜单「技能」入口（或输入框上方的【技能】按钮），进入技能市场——类似 App Store 的界面；
  2. 搜索关键词（如"Excel清洗""PPT生成""agent-browser"）；
  3. 点击技能卡片的「安装」/「+」，等待进度条完成（3-8 秒）；
  4. 显示「已启用」即装完，大部分情况装完即生效，无需重启软件。

方式三：对话导入 / 上传技能包

聊天框输入"导入技能"，或直接拖拽 SKILL.md 文件进去；也可通过「专家 → 技能 → 添加技能 → 上传技能」上传技能压缩包（ZIP）一键安装。本地手动加载（开发者方式）：把 SKILL.md 拷贝到 ~/.workbuddy/skills/ 后重启 WorkBuddy。

方式四：从 Git 仓库导入

「技能管理 → 从 Git 仓库导入」，粘贴 GitHub 仓库克隆地址，系统自动校验签名与完整性后启用——适合导入社区开源技能。

2.3 怎么找到适合自己的技能（官方建议四步法）

  1. 先搜官方：技能中心搜场景关键词（"小红书""会议纪要"），官方技能优先，安全有签名；
  2. 再搜社区：官方没有就去 OpenClaw 社区找，看下载量和更新日期；
  3. 问它自己：直接问 WorkBuddy"我要做 XX，该装什么技能"，装 find-skills 技能后它自己会检索推荐；
  4. 装完验证：下一个最小任务测试（比如装了 xlsx 技能就让它"读这个表并汇总"），跑通再正式用。

2.4 值得优先安装的技能

新手万金油三件套：

  • 浏览器自动化：让 AI 真正"进入"网页——模拟真实浏览行为，打开页面、滚动、点击按钮、展开折叠内容，对付需要展开滚动才能看全内容的动态网页特别实用；
  • 本地文件处理：文件批量整理、重命名、分类的基础能力；
  • 联网搜索：让 AI 能实时查资料。

办公文档四件套（职场最高频）：

↔ 左右滑动查看完整表格
技能能干什么
pdf抽正文、抽表格、OCR 识别、拆分合并、表单填写
docx生成 Word、整理结构、补目录页码、处理批注修订
pptx读取幻灯片内容、总结每页、重做演示文稿
xlsx清洗数据、补公式、整理列、输出汇总

进阶可选：IMAP/SMTP 邮件收发（支持多账户和附件）、Web Access 浏览器自动化、find-skills（技能检索）、skill-creator（技能工厂，下文主角）。

2.5 技能使用与管理的要点

怎么用：装好后不需要专门"打开"——两种调用方式：① 对话中自然语言触发（说需求，WorkBuddy 自动识别并调用对应技能，如装了"简历信息提取"技能后说"帮我提取这几份简历的信息"）；② 点名调用（"用 web-scraper 帮我抓取某官网的公告列表，结果存成 Excel"）。部分技能还会出现在输入框上方的快捷栏中，点击即触发。

管理原则（重要）：

广告媒流（小程序）-小红书
  • 可随时开关：不用的时候直接关闭，不影响其他技能、也不用卸载；关闭后对话中不再被调用；
  • 少而精：装太多不常用的技能只会增加干扰并浪费积分，保留高频三五个，定期清理；只启用当前任务所需的技能；
  • 冲突要禁用一个：两个技能抢同一类任务时（如两个 PDF 技能），禁用其中一个，避免"路由摇摆"；
  • 更新后重验：技能升级后跑一次标准测试任务，确认行为没变；
  • 来源要可信：优先官方 SkillHub；第三方技能先看权限要求，索取文件/网络权限过多的不装；多数技能是安全的 Markdown 文件，含脚本的会在执行前征求你同意。

3 创建自定义技能：四种方法

3.1 方法一：对话式沉淀（最常用，两句话搞定）

这是性价比最高的方式——先把活干一遍，干满意了再"沉淀"。

第一步：正常完成一次任务。 例如处理简历：

"读取桌面上「简历」文件夹里的所有 PDF 简历，帮我根据简历内容做成一张候选人 Excel 表，包含候选人的基本情况。"

第二步：让它变成技能。

"帮我把以上能力转换成 skill 方便我以后调用"

WorkBuddy 会自动记录你的操作步骤和指令模板，保存为一个新技能。之后再来一批新简历，一句"用简历提取技能处理桌面上的新简历"，全程一句话搞定。

再比如英语教师场景：先带着 AI 完成一次初二英语单元出题（题型、难度、格式都调满意了），然后说：

"把我们刚才这套出题流程封装成一个自定义 Skill 技能包，技能名称：初二英语单元出题工具；触发关键词：出英语试卷、初二阅读考卷、单元英语测试；固定执行规则严格按照刚才对话里的全部要求执行。"

AI 调用 skill-creator 初始化技能包结构、生成 SKILL.md，弹窗问"是否保存到本地技能库"，确认后技能即可用。

3.2 方法二：skill-creator 引导创建（技能工厂）

skill-creator 是 WorkBuddy 内置的"技能工程化工具"，专门用于指导和辅助创建新 Skill——它本身不执行业务任务，而是帮你从零到一完成一个可复用的技能模块。核心特点：模块化设计、渐进式加载（三级加载机制节省上下文：元数据常驻 → SKILL.md 按需 → 资源文件再按需）、模板化创建（init_skill.py 一键生成标准目录结构）、自动验证打包（package_skill.py 校验格式并打包为 ZIP 分发）。

使用方式：在对话中直接描述创建需求，例如：

"请帮我创建一个微信 skill，要求：1、输入微信文章链接；2、抓取标题、发布时间、作者、正文；3、保存成 markdown；4、下载正文图片到 images/ 文件夹；5、生成 docx 文件"

WorkBuddy 自动调用 skill-creator：初始化目录结构 → 编写核心脚本 → 生成 SKILL.md 描述文件，几分钟后初版 Skill 出现在技能列表里。保存时注意弹窗的技能库位置提示（默认 C 盘，可不同意更换位置）。

3.3 方法三：手写 SKILL.md（最灵活，10 分钟）

找不到合适的现成技能时，自己写一个。不需要任何编程基础，就是用自然语言写给 AI 看的"岗位说明书"。

第一步：梳理你的 SOP（标准作业程序），回答四个问题：

  • 场景描述：想把什么工作流程自动化？越具体越好；
  • 触发条件：什么情况下会用到这个技能？
  • 输出要求：期望 AI 吐出什么格式、什么内容的结果？
  • 专业背景：你的行业领域是什么？需要补充哪些背景知识？

偷懒秘籍：别被 .md 后缀吓到——把整理好的需求直接扔给 DeepSeek/ChatGPT（或 WorkBuddy 自己），说"帮我把这段需求转成标准的 SKILL.md 格式"，出来不完美就倒逼它迭代修改。

第二步：填写 SKILL.md 标准模板（YAML 头 + Markdown 正文）：

---
title: "你的技能名称"
summary: "一句话描述这个技能是干嘛的"
read_when:
  - 触发条件 1
  - 用户说"xxx"时触发
---

# 技能标题

你是一位【硬核角色定义/专家身份】。
收到任务后，请严格按照以下流程执行：

1. 第一步：xxxxx
2. 第二步：xxxxx
3. 第三步：xxxxx

## 输出格式要求

* 必须包含：xxx
* 整体排版格式为：xxx

一个真实可参考的范例——"内容选题分析专家"：

---
title: "内容选题分析专家"
summary: "分析选题质量，给出评分和优化建议"
read_when:
  - 用户需要评估选题
  - 用户说"帮我看看这个选题"
---
# 内容选题分析专家

你是一位有 10 年经验的内容总监。收到选题后，从以下维度评估：
1. 搜索热度（预估流量潜力）打分 1-10
2. 竞争程度（同类内容数量）打分 1-10
3. 差异化空间（我方优势角度）打分 1-10
4. 变现潜力（广告/带货适配性）打分 1-10
综合打分，给出 2 个改进建议。
输出格式：评分卡片 + 优化后的 3 个标题备选。

保存后，重开对话，直接说"帮我看看这个选题"，WorkBuddy 就会自动调用这个 Skill。

第三步：保存到技能目录并测试。文件保存路径：.workbuddy/skills/[你的技能名]/SKILL.md；写完在技能中心"从本地导入"打包的 ZIP 即可生效；触发词要精准——设了触发词后，测试一遍确保能正确触发。

3.4 方法四：图形化创建（零代码，点击配置）

不写文件，纯界面操作：

  1. 登录 WorkBuddy 客户端，进入「技能」管理页面（部分版本路径：个人中心 → Claw 设置 → Skills 管理）；
  2. 点击「+新建技能」/「创建技能」；
  3. 填写四个核心参数：name（技能名称，要直观，如"自动整理下载文件"）、description（写清能做什么、适合什么场景）、files（参考文件——最关键的一项，把相关参考素材、过往案例、规范文档都传上去）、modelId（默认通用模型即可，专业领域可选垂直模型）；
  4. 选择执行动作类型（如「本地文件操作」），在动作配置区勾选「扫描指定路径」等具体动作；
  5. 点击「保存并启用」。

实战示例——"整理微信文件"技能：技能名称"整理微信文件"，触发关键词"整理微信"，执行动作为"扫描下载文件夹中所有来自微信的文件（文件名含'微信'或'WeChat'），按日期分类到子文件夹"。创建完成后说一句"整理微信"，全部步骤自动执行。

3.5 四种方法怎么选

↔ 左右滑动查看完整表格
方法门槛适合
对话式沉淀零（两句话）刚跑通一个满意任务的人——新手首选
skill-creator低（描述需求即可）需要脚本和复杂结构的专业技能
手写 SKILL.md低（会打字就行）想精细控制流程和触发词的人
图形化创建零（纯点击）偏好界面操作、不想碰文件的人

4 一个完整案例：把周报整理做成 Skill（逐步拆解）

拿"周报整理"完整拆一遍，这个案例可以照抄。简单起步结构：

周报整理/
├── SKILL.md              ← 核心：告诉AI做什么、怎么做
├── templates/
│   ├── 个人周报模板.md
│   └── 项目周报模板.md     ← 固定结果结构
├── references/
│   └── 周报写作规则.md     ← 保存长期规则
└── examples/
    ├── 示例输入.md
    └── 示例输出.md         ← 告诉AI什么输入输出符合预期

SKILL.md 草稿（可直接修改使用）：

---
title: "周报整理"
summary: "根据一周内的工作材料生成个人、项目或部门周报"
read_when:
  - 用户需要生成周报
  - 用户说"帮我整理周报"
---

# 周报整理 Skill

## 适用场景
当用户需要根据一周内的工作材料生成个人、项目或部门周报时使用。

## 输入材料
- 本周工作记录
- 项目进展
- 会议纪要
- 相关数据
- 周报模板

如果缺少能够证明工作进展的材料，先列出缺失项，不得编造。

## 执行步骤
1. 读取并列出全部材料
2. 按项目或主题合并信息
3. 标记已完成、进行中、受阻和待确认事项
4. 提取结果、数据、节点和交付物
5. 整理风险及需要的支持
 根据用户提供的内容整理下周计划
7. 按模板生成周报
8. 输出待确认问题和检查清单

## 输出要求
（按你的公司/团队格式补充：结构、字数、语气等）

注意这条规则的设计："缺少材料先列缺失项，不得编造"——这是防止 AI 幻觉的关键约束，写自定义技能时强烈建议加上类似条款。

5 团队共享与变现

  • 团队共享：把 Skill 放到项目级 .workbuddy/skills/ 目录，跟随代码仓库（Git）一起管理，团队成员即可共用；也可将技能打包 ZIP 直接发给同事上传；
  • 上传 SkillHub 分享：已创建的技能（甚至专家）可上传至 SkillHub 共享给社区；
  • 积分收益：结合第一篇的福利信息——开发者上传技能包、撰写技术文章可获积分与额外积分激励（积分可兑换 Tokens）；通过腾讯云开发者社区发文赚积分时，注意使用与社区一致的账号登录。

版本管理最佳实践：SKILL.md 放入 Git 维护；技能聚焦单一领域（避免过宽）；高频 Skill 常驻加载。

6 技能使用避坑清单

  1. 装太多互相干扰：只开当前任务用得到的，保留高频三五个，定期清理；
  2. 触发词不精准：触发词太宽泛会被无关对话误触发，太生僻又调不出来——设定后务必测试；
  3. 两个技能抢同一类任务：禁用一个，避免路由摇摆；
  4. 技能升级后不重验：更新后跑一次标准测试任务，确认行为没变；
  5. 来源不可信乱装：第三方技能先看权限要求，索取文件/网络权限过多的不装；涉及删除、资金等敏感操作先小范围测试；
  6. 敏感数据处理：涉及隐私的技能注意数据边界，谨慎处理；
  7. 一开始就堆脚本：不要为了让 Skill 看起来高级就堆很多文件——SKILL.md + 模板 + 示例足够起步，确实需要批量处理/自动计算时再加脚本。

7 本篇小结与自测

本篇要点回顾：

  1. Skill = 手机 App / 给 AI 的岗位说明书：一个文件夹 + SKILL.md（写清名称、触发条件、执行步骤、输出格式）；与提示词的区别在于持久化、可复用、可分享；
  2. 三大来源：官方内置、OpenClaw 社区生态（SkillHub）、自定义创建；四种安装方式：对话安装、SkillHub 图形化、上传/导入 ZIP、Git 仓库导入；
  3. 官方找技能四步：先搜官方 → 再搜社区 → 问它自己（find-skills）→ 装完用最小任务验证；
  4. 新手万金油三件套（浏览器自动化/本地文件处理/联网搜索）+ 办公四件套（pdf/docx/pptx/xlsx）；
  5. 四种自定义方法：对话式沉淀（新手首选，两句话）、skill-creator 引导、手写 SKILL.md（YAML头+正文四步法）、图形化创建；
  6. 技能管理：可随时开关、少而精（高频三五个别贪多）、冲突禁用一个、更新后重验、权限过高的不装；
  7. 团队共享放项目级目录进 Git；SKILL.md 里加"缺材料不得编造"防幻觉条款。

自测题：

  1. SKILL.md 的 YAML 头里最关键的三个字段是什么？分别回答什么问题？
  2. 你刚用对话跑通了一个"发票整理"任务且结果满意，写出把它变成技能的那句话；
  3. 两个 PDF 技能同时启用会发生什么？该怎么处理？
  4. 为什么 SKILL.md 里要写"缺少材料先列出缺失项，不得编造"？