ARTICLE · 1295988

WorkBuddy 技能安装及使用指南

发布时间：2026-11-02 14:20:54 最近访问：2026-11-02 14:20:54

WorkBuddy 技能安装及使用指南

很多人装上 WorkBuddy 之后，只用了它「会聊天」的那一部分。真正让它变成你的专属助手的，是技能（Skill）。

技能就像给助手发一本岗位手册：把某类活儿的做法、格式、注意事项一次性写清楚，它以后每次遇到这类活儿就照着做，不用你从头讲一遍。

这本手册会带你走完「认识技能 → 安全安装 → 真正用起来 → 自己做技能」的完整路径，每一步都写清楚点哪里、说什么、装完怎么验证。

📖 一、写在前面

1. 这本手册适合谁

刚装好 WorkBuddy，还不知道「技能」是什么的新手
想让 AI 稳定产出固定格式文档（课纲、方案、报告、台账）的职场人
带团队做培训 / 做交付，想把自己的方法论固化下来复用的人

2. 读完你能做到

说清楚技能、连接器、专家三者的区别，不再装错东西
掌握 4 种安装方式，并在安装前完成安全体检
用对方式调用技能，一眼判断它到底有没有生效
把一个重复干了三遍的流程，封装成自己的专属技能

3. 建议的阅读顺序

如果你现在是……	直接看这几章
完全没装过技能	第二章 → 第四章 → 第五章（方式一）→ 第六章
已经装过几个，用得不顺	第六章 → 第七章 → 第九章
想做自己的技能	第二章（第 4 节）→ 第五章（方式四）→ 第八章
要给团队统一配技能	第四章 → 第七章 → 附录 A

🧩 二、先搞懂：技能到底是什么

一句话：技能是一个装着「做法说明」的文件夹，核心是一个叫 SKILL.md 的文件。AI 读到它，就相当于拿到了这份工作的标准作业流程。

1. 三个容易搞混的概念

技能 Skill：一本「怎么做」的说明书，含步骤、格式、可附带脚本和模板。适合某类任务要反复做、且要求稳定输出时。
连接器 Connector：一条通往外部平台的通道（腾讯文档、邮箱、网盘、CRM 等）。适合需要读写外部平台的数据或文件时。
专家 Expert：一个带专业视角和人设的角色，影响 AI 怎么思考。适合需要专业判断、深度研究或多角色协作时。

💡 提示　判断口诀：要「做法」装技能，要「数据」连连接器，要「脑子」请专家。三者可以叠加使用。

2. 技能为什么比「每次重新描述一遍」更管用

技能采用三级加载，既不占空间，又能在需要时把细节全部调出来：

第一级｜加载内容：技能名 + 一句话描述｜什么时候加载：一直在后台（约 100 字）｜打个比方：书架上的书名
第二级｜加载内容：SKILL.md 正文｜什么时候加载：命中这个技能时才读｜打个比方：翻开书的目录和正文
第三级｜加载内容：脚本 / 参考文档 / 模板｜什么时候加载：用到时才取（容量不限）｜打个比方：书后附的表格和光盘

这意味着：你装 20 个技能也不会拖慢对话，因为平时只有「书名」在后台；而一旦命中，AI 又能拿到完整的操作细节。

3. 一个技能包长什么样

my-skill/ ← 技能文件夹（名字就是技能名）├── SKILL.md ← 必需：核心说明书├── scripts/ ← 可选：要反复跑的脚本（Python / Bash 等）├── references/ ← 可选：长文档、规范、字段说明└── assets/ ← 可选：模板、图片、字体、示例文件

SKILL.md（必需）：放目的、触发时机、执行步骤、注意事项。判断标准——一定有。
scripts/（可选）：放确定性的重复代码。判断标准——同一段代码要写第三遍时就塞进来。
references/（可选）：放舍不得塞进正文的长规范、字段表、接口文档。判断标准——正文放不下、但又需要 AI 知道的内容。
assets/（可选）：放模板文件、图片、字体、示例。判断标准——最终产出物里要直接用到的文件。

同一个动作，你做过三次，它就该变成一个技能。这不是偷懒，这是把经验存起来——人走了，方法还在。

🔍 三、技能从哪来：四条获取路径

① 推荐市场安装｜怎么来的：WorkBuddy 内置市场，搜到点安装｜适合谁：绝大多数人，首选｜难度：⭐
② 对话里一句话装｜怎么来的：直接对 AI 说「帮我装个 X 技能」｜适合谁：懒得翻界面的｜难度：⭐
③ 本地导入｜怎么来的：把技能文件夹或 zip 放进技能目录｜适合谁：别人分享给你的 / 团队下发｜难度：⭐⭐
④ 自己做｜怎么来的：让 AI 帮你写 SKILL.md 并保存｜适合谁：有固定流程想固化的人｜难度：⭐⭐⭐

💡 提示　90% 的需求，走路径 ① 就够了。只有当你想把「自己的方法」变成能力时，才需要走到 ④。

🛡️ 四、安装前必做：给技能做个体检

技能不是普通插件——它可以让 AI 执行命令、读写文件、访问网络。所以从外部（市场、社区、他人分享）安装之前，先做一次安全体检，这一步不能省。

1. 三步安全流程

告诉 AI 你要装什么技能（名字或来源都行）
让它先跑一遍安全审查，对 SKILL.md 及附带的所有脚本、文档做一次通读
看完风险等级再决定：通过就装，有风险就先问清楚再点确认

2. 风险等级怎么看

等级	意味着什么	你该怎么做
P2（安全）	没有发现可疑操作	正常安装，放心用
P1（需留意）	有外部访问、文件写入等敏感动作	看清它要读哪里、写到哪里，确认无害再装
P0（高危）	存在越权、外传数据、破坏性命令等	不建议安装；确实需要的话，务必先隔离环境试用

3. 重点看这三处

有没有联网请求——往哪里发数据？
有没有删除 / 覆盖 / 批量改名的命令——作用范围是哪个目录？
有没有要求你提供密码、密钥、令牌——正规技能不会索要这些

⚠️ 注意　任何时候，只要一个技能让你填密码、授权码、API Key 之类的敏感凭据，先停下来问清楚。正常技能会走官方授权流程，不会让你把密钥贴在对话里。

🛠️ 五、四种安装方式，手把手

方式一｜推荐市场一键安装（首选）

在左侧导航栏点击「技能」，进入技能面板
在搜索框输入关键词（如「发票」「会议」「PDF」），支持中文
点开技能卡片，先看三件事：简介、版本、更新说明
确认无误后点击「安装」，按提示完成
安装成功后，在「已安装」列表里能看到它

【成功标志】回到对话框，说一句这个技能对应的需求，AI 会主动调用它；或者在技能面板的已安装列表里找到它。

方式二｜对话里一句话安装（最省事）

不用找入口，直接在输入框里说话就行：

帮我装个发票整理的技能安装 PDF 处理技能我想用能整理会议录制的技能，帮我装一下

接下来 AI 会：搜索市场 → 找到最匹配的一个 → 告诉你名字和版本 → 问你确认 → 装好并告诉你装到了哪里。如果搜出来好几个，它会列出来让你挑一个。

💡 提示　如果它回复「没找到」，换个更具体的说法再试一次，比如把「整理文件」换成「批量重命名 PDF」。

方式三｜本地文件夹 / 压缩包导入

适用于同事分享、团队下发、或从社区下载的技能包。

先确认技能包的存放位置（见下表）
把整个技能文件夹（或解压后的文件夹）复制进去
确认目录里能看到 SKILL.md 这个文件
回到 WorkBuddy，新开一段对话让它生效

级别	Windows 实际路径	生效范围	适合放什么
用户级（推荐）	C:\Users\你的用户名\.workbuddy\skills\	所有项目都能用	个人常用技能
项目级	项目根目录\.workbuddy\skills\	只在当前项目生效	团队共用的项目规范

放置示例：# 例：把技能文件夹复制进用户级目录把 my-skill 整个文件夹放到：C:\Users\你的用户名\.workbuddy\skills\my-skill\# 正确结构长这样：skills\my-skill\SKILL.md ← 必须有这一层，别把文件散着放

⚠️ 注意　解压后如果里面还有一层同名文件夹，要把「含 SKILL.md 的那一层」放进去，否则 AI 找不到它。同时也别把 .zip 直接丢进目录——必须先解压。

方式四｜从零做一个自己的技能

当你有一个固定流程想固化时，直接对 AI 说：

帮我创建一个技能，功能是：把每周的销售数据整理成周报。输入：Excel 表格输出：Word 周报，包含本周概览、区域排名、异常提醒、下周建议

AI 会生成 SKILL.md 并保存到技能目录，之后你再说「整理这周销售周报」，它就会按这套流程走。详细的写法规范见第八章。

🚀 六、装好之后，怎么用起来

1. 三种调用方式

自动匹配：正常描述需求，AI 判断需要就自动调用。适合日常使用，最省心。
@ 点名：在输入框打「@」选择技能，或直接写 @技能名。适合想指定用某个技能时。
斜杠命令：输入 /技能名直接唤起。适合熟练之后，最快。

2. 怎么判断它到底有没有生效

看过程：AI 开始按技能里写的步骤走，而不是临场发挥
看产出：格式、结构、用词跟你技能里要求的一致
直接问：问它「你刚才用了哪个技能」，它会告诉你

3. 三个真实场景示范

写课程大纲｜你说：帮我做一份《AI 高效办公》1 天课纲｜技能接管后：按你定好的课纲结构、时段分配、措辞规范来写｜你拿到：一份可直接交付的 docx
发票整理｜你说：把这个文件夹的发票 PDF 整理成台账｜技能接管后：批量读取、提取字段、汇总去重、生成表格｜你拿到：明细 + 汇总两个工作表的 Excel
视频转笔记｜你说：把这节课的视频做成图文笔记｜技能接管后：抽帧、转录、按模板排版、配图｜你拿到：结构化的 Markdown 笔记

装完一个技能，立刻拿一件真事跑一遍。装十个不用的技能，不如把一个用顺手。

🗂️ 七、技能管理：查看、更新、改、停用、删

看看装了哪些：在对话里问「我装了哪些技能」，也可以直接去看 skills 文件夹。
更新到新版：在技能面板点更新，或让 AI 帮你装最新版。注意：自己改过的技能，更新前要先确认会不会被覆盖。
改一改内容：直接让 AI 修改某个技能。注意：AI 自己创建的技能才能用工具改；改过之后建议做一次版本备份。
暂时不用：在技能面板停用，或直接移出技能目录。注意：停用比删除安全，随时能加回来。
彻底删除：让 AI 删除，或手动删除对应文件夹。注意：删除前确认里面没有你自定义的模板和脚本。

改了从市场装来的技能，要注意什么

如果你修改了市场安装的技能内容，系统会给它打一个「已被用户修改」的标记。之后市场推新版本时，会先问你要不要覆盖，不会悄悄把你的改动冲掉。所以放心改——但改完最好自己另存一份备份。

定期整理

三个月没用过的技能，删掉或归档，别让列表越来越长
功能重复的技能只留一个，避免 AI 挑错
发现两个技能名字相似、职责重叠，就合并成一个

✍️ 八、进阶：写一个好用的 SKILL.md

1. 五步法

说清楚需求：这个功能具体要处理哪些任务？给我几个真实例子
盘点可复用资源：哪些脚本、规范、模板值得一起打包放进去
建文件夹：放到用户级还是项目级，先定好位置
写 SKILL.md：填头部信息 + 正文三段式
真跑一遍再迭代：用真实任务测，把踩到的坑补写进去

2. 头部三件套（最关键，别偷懒）

name｜必需｜小写英文 + 连字符，见名知意｜示例：invoice-ledger
description｜必需｜写清「干什么」和「什么时候用」，把触发词直接列出来｜示例：把发票 PDF 批量整理成 Excel 台账。当用户说「整理发票」「发票台账」时使用
agent_created｜强烈建议｜让 AI 创建的技能填上 true｜示例：agent_created: true

💡 提示　description 决定 AI 什么时候想起它。写「处理文档」太泛，写「把 Word 会议纪要转成标准格式的周报」才是好描述——触发词直接写进去，命中率会高很多。

3. 正文三段式

这个技能是干什么的｜回答：目的和适用范围｜写作要点：两三句话说清，别展开
什么时候该用它｜回答：触发条件｜写作要点：列出典型说法和场景关键词
具体怎么做｜回答：执行步骤｜写作要点：编号步骤，指令式语气；失败路径也要写清楚

语气上用「先做 A，再做 B」这种指令句，不要写「你应该……」。这是给 AI 看的操作手册，不是给人看的说明书。

4. 配套资源怎么用

scripts/｜放要反复执行的确定性代码｜判断标准：同一段代码要写第三遍时
references/｜放长规范、字段说明、接口文档｜判断标准：正文放不下、但 AI 需要知道
assets/｜放模板、图片、字体、示例文件｜判断标准：最终产出物里要直接用到

同一份内容只放一个地方：正文里有的，就别再塞进 references；反过来，塞进 references 的，正文里只留一句「按 references/xxx.md 执行」就好。正文保持精简，AI 才抓得住重点。

5. 可直接抄的最小模板

---name: my-skilldescription: 一句话说明这个技能做什么。当用户说「触发词A」「触发词B」时使用。agent_created: true---# 技能名称## 用途两三句话说明这个技能解决什么问题。## 使用场景- 用户说「……」时- 需要处理……时## 执行流程1. 第一步：做什么，输入是什么2. 第二步：调用 scripts/xxx.py，参数说明3. 第三步：按 references/xxx.md 的格式要求整理输出4. 输出前自检：检查项一、检查项二## 失败处理- 如果出现 A 情况：改用 B 方案- 如果遇到 C 报错：先检查 D，再重试## 注意事项- 约束一- 约束二

别追求一次写完美。技能最值钱的地方，是每次用完把新踩的坑补进去——写着写着，它就成你的独家资产了。

💡 九、高手心法 & 避坑清单

五条心法

一次只装一个，装完立刻用一次，跑通了再装下一个
重复三次的活儿就做成技能，别第四次还手动来
踩过的坑写进技能，下次它就不会再犯
SKILL.md 保持精简，细节放 references 里
每季度清一次技能列表，该删删、该合合并

避坑清单

装了却从没被调用｜大概率原因：description 写得太泛，AI 认不出｜怎么办：把触发词和典型说法直接写进描述
AI 总是挑错技能｜大概率原因：两个技能职责重叠｜怎么办：合并成一个，或把描述区分开
换了项目就用不了｜大概率原因：装到了项目级目录｜怎么办：挪到用户级目录，全局生效
解压后找不到技能｜大概率原因：多套了一层文件夹｜怎么办：把含 SKILL.md 的那层放进 skills 目录
改完又被覆盖｜大概率原因：市场新版自动更新了｜怎么办：改过的技能另存备份，更新前先确认
跑脚本报错｜大概率原因：运行环境缺依赖或路径不对｜怎么办：把环境要求和依赖安装步骤写进技能正文

❓ 十、常见问题

问题	解答
要装多少个技能合适？	不用追数量。常用的是那五六个，装够用就行，装多了反而互相干扰
装技能要花钱吗？	市场里的技能大多免费，具体以技能卡片上的标注为准
能自己改别人的技能吗？	能。改完系统会标记为已修改，后续更新会先征求你的意见
技能会不会读到我别的文件？	技能只在它被触发、且你授权的前提下工作。敏感的还是先做安全审查
重装客户端技能会丢吗？	技能存在本地 skills 目录里，重装前把这个文件夹备份一份最稳妥
一个技能能装在两个地方吗？	同名技能两边都放会冲突，建议只保留一份，优先用户级
不会写代码能做技能吗？	能。最简单的技能就是一个 SKILL.md，把做法用文字写清楚就够用

📎 十一、附录

附录 A：推荐安装顺序（按阶段来，别一口气装完）

第一阶段 · 打底｜配什么：文档、表格、演示三类办公技能｜目的：把最常用的产出跑通，立刻能见效
第二阶段 · 提速｜配什么：浏览器自动化、会议录制整理｜目的：把重复劳动交给 AI，省下机械时间
第三阶段 · 联通｜配什么：常用的云文档、网盘、协作平台连接器｜目的：文件不用再来回倒腾
第四阶段 · 定制｜配什么：把自己或团队的固定流程做成专属技能｜目的：从「会用工具」到「有方法论资产」

附录 B：装完一个技能的自查清单

□ 做过了安全审查，风险等级可接受
□ 放在了正确的位置（个人用放用户级，团队共用放项目级）
□ 目录里能看到 SKILL.md
□ 拿一件真事跑通了一遍
□ 产出物符合预期，不符合就把要求补写进技能

附录 C：常用路径速查

项目	Windows 路径
用户级技能目录	C:\Users\你的用户名\.workbuddy\skills\
项目级技能目录	你的项目根目录\.workbuddy\skills\
技能核心文件	每个技能文件夹下的 SKILL.md
备份建议	重装或升级前，把整个 skills 文件夹复制一份存好