WorkBuddy 智能体实战手册：自定义技能开发、知识库对接与多场景 AI 自动化落地拆解

本文由 莫潇羽@源码七号站（www.fuyuan7.com）撰写，转载请注明出处。

快速摘要

先说结论。办公智能体和你手机里那个聊天窗口最大的差别，不是"模型更聪明"，而是它交付的是文件，不是回答。 你把一件事丢进去，它会自己拆步骤、自己去读你电脑上的文件夹、自己调工具，最后给你一个能双击打开的东西——一张整理好的表、一份报告、一段视频、一个网页。

第二个结论：这类工具真正拉开差距的地方，从来不是模型，而是三样东西——技能（把重复流程固化下来）、连接器（让它能碰到外部的文档和表格）、知识库（让它的记忆不随着缓存被清空而消失）。 这三样东西搞明白，剩下的事都是熟练度问题。

第三个结论：新手最容易死在一个特别不起眼的环节——没把任务交代清楚。 尤其是"口径"这一项。同一份订单数据，退款算不算销售额、外币要不要折算、折扣率的分母是谁，你不说，它就自己猜；它一猜，后面所有结论全歪，而表面上看还特别漂亮。

第四个结论：验收必须自己做。 至少要能回答三个问题：这个数字能不能在你给的原始文件里找到出处？已完成和待确认有没有被分开？你的原始文件有没有被改过？这三条过不去，交付就是废的。

第五个结论：合规要提前想。 AI 生成内容要按《人工智能生成合成内容标识办法》做显式与隐式标识；声音克隆、形象克隆必须先拿到本人书面授权；素材、字体、音乐商用要取得正版授权。这几条不是"以后再说"的事，是动手前就该摆到桌面上的事。

本文会按"先认清工具，再把事说清楚，接着让智能体长出技能、手脚和记忆，然后进五个具体场景，最后落到验收与合规"的顺序，把整套流程拆一遍。想看完整拆解，往下翻。

一、先认清对手：办公智能体和聊天窗里的 AI 差在哪

我第一次打开 WorkBuddy 的时候，心里的判断挺敷衍的——"又是一个套壳聊天窗"。用了三天之后我改了看法，但改的也不是"它多聪明"，而是"它愿意去碰我的文件"。

这件事听起来平平无奇，实际上是分水岭。

一次对话和一次交付，是两回事

聊天型 AI 的运转方式是：你问一句，它答一句；你不问，它就停。你给它一份表格，得先手动上传或者复制粘贴；它看完给你一段分析建议，这段建议对不对、怎么落地，全归你自己管。

办公智能体的运转方式不一样。你把目标丢给它，它自己拆解、自己规划、自己调用工具，最后落一个文件出来。这个区别用一张图说最清楚：

flowchart LR
    A[理解目标] --> B[拆解任务]
    B --> C[调用工具与技能]
    C --> D[交付可验收的产物]
    D -.发现问题.-> A

拆开看，就是四步：

1. 理解目标：它要先搞明白你究竟要解决什么问题，包括你前面给过的限制条件、上下文里出现过的文件。
2. 拆解任务：把一个大目标切成若干可执行的小步骤，排出先后顺序。
3. 调用工具：到某一步需要读表格、跑脚本、联网查资料、调外部接口的时候，它去用技能、连接器、MCP 这些东西完成任务。
4. 交付产物：把结果落成文件交给你，同时把中间过程保留下来，你能看到它每一步干了什么，跑偏了可以直接打断它。

这四步不是 WorkBuddy 独有的，市面上叫得上名字的智能体基本都是这个骨架。区别在于第三步"能碰到什么"，这一项决定了它到底是个吉祥物还是真能干活的。

我自己的体感是：临时问一句的事，别用它，聊天窗口更快；一周要做三次以上的事，赶紧用它，并且要逼自己把它固化成技能。 这句话后面会反复出现，因为它几乎是整套方法论的地基。

三块拼图：技能、专家、连接器

WorkBuddy 的能力入口可以粗暴地归成三块，理解了这三块，界面上那些按钮就不再是乱码。

• 技能（Skill）：说人话就是"把一套流程写成一个说明文档，丢进一个文件夹，以后一句话就能调起来"。你可以把它当成手机上的应用，也可以当成给新同事看的操作手册。区别在于，这份手册是给 AI 看的。
• 专家：可以理解成"已经把多个技能搭好、还配好了角色设定的一整套方案"。你不用自己去拼技能，直接找一个专家来干活。缺点是额度消耗比单个技能快。
• 连接器：让智能体能够碰到外部系统的东西。飞书文档、多维表格、腾讯文档、邮箱、知识库，基本都在这个范畴里。

这三块之外还有两个容易被忽略的东西。一个是自动化，让任务按周期自己跑；一个是工作空间，决定它的对话和产物落在哪个文件夹下面。工作空间这一项特别容易踩坑——你不选，对话就散落在默认列表里；你选了，它才在一个固定的上下文里干活。

它在哪里跑，你要清楚

这里有个很多人一开始想不明白的点：智能体可以跑在云端，也可以跑在你本机。

区别是这样的：如果任务不需要碰你电脑里的任何文件，走云端就够了，手机发指令、云端跑完、结果回传，你电脑开着关着都不影响。如果任务要读你本地的文件夹、要改你本地的东西，那必须让本机在线，而且不能让电脑进入睡眠——电脑一睡，手机那头就彻底联系不上了。

所以稳定的做法是：把本机的屏幕锁定远程唤醒、远程连接这类开关打开，让机器在你需要的时候能被叫醒。

装之前先看一眼环境

这部分没什么技术含量，但装完才发现不兼容，会白白浪费一个下午。

装完之后先做一件事：进设置，把默认存储路径从系统盘改到别的位置。这一步花你两分钟，能省掉以后电脑变卡时的很多麻烦。

额度这件事，早点建立概念

这类工具的消耗单位各家叫法不一样，有的叫积分，有的叫额度，本质是同一个东西：你调用模型、生成图片、合成视频，都要扣。

有一点要提前说清楚：额度通常是时效性的，平台经常会发一些限时额度、每日签到额度、完成任务送的额度。日常的轻量任务用这些基本够，重度的生成类任务（长视频、批量出图）就明显不够了。

我不太建议一上来就研究怎么把额度用满，那不解决根本问题。真正值得花时间的是：把高频流程固化成技能之后，单次消耗反而会降下来——因为它不用再反复试错，不用再让你来回确认十几轮。

至于各家具体怎么算、单价多少，写稿的时候我看到的数字只能算个近似行情，这类定价变动非常快，请以官方定价页面的实时数据为准。

二、新手最容易死在哪：把一件事交代清楚

写这篇文章之前我回头翻了几个翻车现场，发现原因高度集中在同一个地方：不是 AI 不行，是话没说明白。

有个特别典型的例子。我让智能体整理一份订单数据，出营业额汇总。它跑得飞快，三十秒给了一份漂亮的报告。我一开始还挺满意，越看越不对劲——订单条数比实际多了七条，渠道统计多算了一笔，还有两个金额明显是外币没折算。

问题出在哪儿？出在我说的那句话：「帮我统计一下这份订单数据的销售额。」

"销售额"这三个字，在我看来是常识，在它看来是个填空题。

一条完整的任务，要包含五样东西

我把这几年自己用得最顺的结构整理成五个要素。不用每次都写全，但重要的任务最好都过一遍。

1. 目标：你到底要什么结果。是"给我一份能直接发出去的周报"，还是"给我一份待确认的草稿"，这两种说法产出的东西完全不是一个东西。
2. 输入：数据从哪来。是工作空间里某个文件夹，是某个知识库里的某篇文档，还是你打算后面再贴一段文字进去。
3. 口径：这是最关键、最容易被忽略的一项。指标怎么定义的、时间范围多大、特殊情况怎么处理。
4. 约束：硬性的边界。不能改原始文件、时间窗只能取近 90 天、来源必须优先官方文档、页数不能超过 8 页。
5. 产出：交付什么形态。Markdown 报告、Excel 表格、HTML 网页、演示文稿文件，还是同时要几份。

这里还可以补一层更细的说明：产出要说清楚格式、命名、存放位置三件事。格式决定它怎么组织内容，命名决定你以后找不找得到，存放位置决定它会不会覆盖掉你原来的东西。我吃过一次亏，让它生成"一份报告"，它把文件命名成 report.md，放在工作目录根下，然后第二天又生成一份同名的，直接把前一份覆盖了。从那以后我的产出要求里固定加一句：文件名带上日期和序号，不要覆盖已存在的文件。

把这五样拼起来，就是一份能直接复制去用的模板：

# 角色与目标
你是我的数据处理助手。目标：把【订单原始表】整理成一份可用于内部汇报的销售汇总。

# 输入
- 数据源：工作空间 /data 目录下的 order_raw.xlsx
- 若文件缺失，先告诉我缺什么，不要自己造数据

# 口径（必须严格遵守）
- 时间范围：2026-01-01 到 2026-03-31
- 销售额：仅统计"已完成"状态订单；"已退款"和"已取消"不计入
- 币种：统一按人民币口径，外币按当日中间价折算，折算明细单独列出
- 折扣率分母：使用原价，不使用折后价
- 金额单位：元，保留两位小数

# 约束
- 不要修改任何原始文件
- 重复行、无效日期、必填字段缺失的行，必须单独出一张"排除清单"，注明排除原因
- 报告中所有数字必须标注来源列名

# 产出
1. 汇总表（Markdown 表格）
2. 排除清单（Markdown 表格）
3. 一页结论，事实与推论分开写

看起来啰嗦，但这份啰嗦是有回报的。同一份数据，加了口径约束之后重跑，订单数对上了，渠道分类也对了，多出来的那七条异常行老老实实出现在排除清单里。前后两次的差别，就是我多写的那十几行字。

口径为什么要说死

数据类任务上，口径是唯一不能偷懒的地方。因为它有个特别阴险的性质：口径错了，输出依然好看。

还是用刚才那个例子。它给我的那份报告里，柱状图高度合理、百分比加总正常、文字描述通顺，从视觉上完全挑不出问题。我当时甚至还截了图准备直接用。真正让我起疑的是"订单条数比实际多了七条"这个细节——因为我恰好记得原始表大概有多少行。如果没有这个巧合，我大概率会带着一份错的数据去汇报，而且不会有人发现。所以我在所有数据类提示词里都固定加两条：

• 所有汇总数字必须能回溯到原始表的具体列；
• 任何被排除的记录都要单独列出并注明原因。

这两条加进去之后，它的"猜"就会被逼到台面上来。

顺手给一张我自己常用的检查表，交付前对着过一遍，能拦掉大部分返工：

什么时候让它先给计划

这类工具一般提供两种干活姿态：一种是你问它答，它只回答不替你动手；另一种是先出计划、你点头了它再执行。

我的习惯是分场景：

• 探索性任务——比如"这份数据能看出什么"，用问答姿态，成本低、试错便宜。
• 破坏性任务——涉及写文件、改文件、批量操作，一律先要计划。看它的计划里有没有你不想要的步骤，比如"删除重复行"这件事，有些场景下你其实不想删，只想标记。
• 重复性任务——已经跑顺了的流程，直接全权交给它，甚至封装成技能，不用再看着。

还有一个权限档位的问题。有的工具会给你"只读""可写""完全访问"这种分级。日常我建议先给可写就够了，完全访问留给已经验证过的流程。 不是不信任它，是范围越大，一次误操作的代价越大。

截图，比打字描述省时间

这一条不属于"交代任务"，但特别实用，我放在这里。

程序报错的时候，你花五分钟写一段文字描述错误信息，效果往往不如直接截一张图丢过去。因为它就在你本机，它能看到你屏幕上应该看到什么，也知道你当前环境里缺什么。 我遇到环境相关的报错之后基本不再自己查，截图、发过去、等它判断。

顺带说一句：遇到问题时优先问手边的 AI，比在网上搜答案靠谱。原因很简单，网上的答案是别人的环境，你的环境可能缺了别人有的东西，照抄往往在另一处卡住；而手边的 AI 是在你的机器上，它知道你这台电脑到底装了什么。

一句话总结这一章：它不是读心术，它是执行器。你说得多清楚，它就能干得多准。

三、技能到底是个什么：一个文件夹怎么长成一项能力

"技能"这个词被用得太泛了，很多人第一次听到会以为是插件，以为是会员功能，以为是某种高级提示词。都不是。

技能的本质是一个文件夹，入口文件叫 SKILL.md。 就这么简单。

你可以把它想成一盒药的说明书。药盒本身不重要，重要的是里面那张纸——写清楚这盒药治什么、什么时候吃、一次几粒、有什么禁忌。技能也一样：SKILL.md 里写清楚"这个技能干什么、什么时候用、按什么步骤做、有哪些禁止事项"。

为什么一个文件夹就够

因为这套东西的加载方式是渐进的，这一点如果不理解，后面会踩很多坑。

• 启动阶段：它只读每个技能的"名称 + 描述"。这部分非常短，一个技能大约只占百来个 token 的量级。
• 对话阶段：它拿你的需求去和每个技能的描述做匹配，判断哪些可能相关。
• 激活阶段：真的命中之后，才把 SKILL.md 的正文完整读进来。
• 按需阶段：正文里如果引用了参考文档、脚本、模板，用到的时候再去读。

这个设计的直接好处是：你装几十个技能也不会把上下文挤爆。间接的好处是，它把写技能的要求也定下来了——描述写不好，技能就不会被触发；正文写太长，加载成本就上去了。 这两条基本就是技能能不能用好的一半。

一份最小的 SKILL.md 长这样：

---
name: article-summarizer
description: 对长文做三层总结：一句话概括、分段要点、文章结构梳理。当用户要求"总结文章""概括长文""提取要点""分析文章结构"时使用此技能。
---

## 执行步骤
1. 先输出一句话总结，控制在 50 字以内，让用户能一眼判断要不要继续看。
2. 再按段落输出要点，每段保留原有逻辑顺序，不合并、不重排。
3. 最后输出文章结构，说明它用的是哪种组织方式（提出问题到解决问题、时间线、并列论证等）。
4. 结尾附上处理方式说明：本次输入来自链接、本地文件还是粘贴文本。

## 禁止事项
- 不要添加原文中不存在的数据或案例。
- 不要因为篇幅长就省略中间段落。
- 不要在总结里加入个人评价。

头部的两行是必须的：name 只用小写字母、数字和连字符；description 要把"做什么"和"什么时候用"都写进去，后者尤其重要——它决定触发率。

技能装在哪里，决定了它的适用范围

这是新手最容易搞混的一层。同样是技能，放在不同目录，生效范围完全不同。

我自己的用法是：通用流程放个人级，跟某个具体项目绑死的放项目级。 比如"周报整理"这种我每周都要做的事，放个人级；某个客户的报价规则，放项目级。

有一个现象值得提前知道：项目级技能是"隐藏"的。 你在全局技能列表里搜不到它，只有在打开那个项目的时候它才出现。我一开始以为是自己没创建成功，翻来覆去折腾了几轮才反应过来——它就是只在那一个文件夹下面生效。

从零手工建一个技能，命令行里是这样：

# 个人级技能
mkdir -p ~/.skills/article-summarizer

# 项目级技能（在项目根目录执行）
mkdir -p .skills/article-summarizer

# 然后把 SKILL.md 放进对应目录

目录结构通常会用到三层，都很直白：

article-summarizer/
├── SKILL.md