腾讯文档进资料库,Skill 装到本地目录

场景示意

运维和 IT 管理日常最烦的搬运，往往不是技术本身，而是窗口切换。

纪要在腾讯文档，规范在乐享，个人笔记在 ima，告警结论还要再贴回某一份在线稿。WorkBuddy 若只能在对话框里「根据你粘贴的文字总结」，那它和普通聊天差不太多。公开实战文把话说死了：资料库原生集成，是让 AI 直接调用真实云端资料完成任务，而不是先逼你复制进对话框。

另一条线是 Skill。技能系统决定「用什么专业流程来干」。文档通道解决原料，Skill 解决做法。两条都通，远程小程序下发的任务才像回事。

资料库是 WorkBuddy 整合知识来源的统一入口。公开说明里，左侧栏「资料库」下可管理多类来源；腾讯文档是其中标准来源之一。乐享知识库与 ima 知识库也可按需接入，分别更偏团队知识协作与个人知识检索。授权方式一致：首次完成 OAuth，凭据按来源保存，后续会话自动沿用。

和自定义 MCP 要分清。资料库原生集成面向上述来源；资料库之外的外部系统，才通过自定义 MCP 连接器扩展。别把「接了腾讯文档」理解成「全世界系统都已打通」。

以腾讯文档为例，实战路径就是授权、发起、读取三步：

在「资料库」→「腾讯文档」点立即前往授权，微信或 QQ 扫码完成 OAuth。 授权后，该来源可被任务调用；权限覆盖读取内容、编辑与管理文件等（以授权页实际展示为准）。 用一句话描述需求，例如读取某份文档并归纳要点。WorkBuddy 规划步骤后，直接调资料库读取，再整理产出。

腾讯文档侧支持的在线类型，公开文提到文档、表格、幻灯片、脑图与智能画布等；本地 Word / Excel / PPT / PDF 等若能在腾讯文档打开，也可在资料库勾选加入任务。对 IT 同学，实际体感就是：巡检模板、变更对照表、周会纪要可以留在原处，任务去「够」它们，而不是每周五晚上人工搬运。

授权不是摆设。它的直接效果是：后续任务可以基于资料库里的真实来源执行。你少做的是跨窗口复制；你仍要做的是验收：字段齐不齐、缺失有没有写明、回写前要不要人审。

移动端把「人在外面」补上了。WorkBuddy 提供 App 与微信小程序能力，和桌面端资料库能力互补。

App 侧公开说明有两种执行模式：云端工作模式用云端沙箱跑任务，不依赖个人电脑；连接电脑模式可远程操控桌面端 WorkBuddy。任务可创建、查看、追问与中断。登录支持 QQ、微信等方式，但有一条很实际：App 登录的微信账号应与电脑端一致，否则「连接电脑」可能用不了。首次启动还会申请相机、麦克风、存储与通知等权限，按需给。

微信小程序：搜索 WorkBuddy 并绑定桌面客户端后，可远程发指令、看运行中任务、收完成通知。对值班和出差，价值很具体：不必盯着电脑桌面，也能把「读某份腾讯文档出摘要」这类任务丢回去跑，回来再在文档或本地工作区验收。

远程特别适合两类事：人已经离开工位，但资料仍在已授权的腾讯文档里；以及需要追问、中断长任务，又不想 Remote Desktop 一整屏。它不适合第一次摸权限边界的试验。试验请留在桌面，边界清楚了再放到小程序。

建议节奏仍然保守：先在桌面把「读文档 → 产出可验收文件」跑稳，再开远程。远程只放大你已经稳定的流程，放大半成品只会放大返工。

Skill 是什么？公开深度指南写得很干脆：一个 SKILL.md（可加脚本、参考资料、资源文件），放在 `~/.workbuddy/skills/<技能名>/` 目录下。任务触发时，WorkBuddy 按匹配加载技能，按其中的流程指引工作。

技能通常提供三样东西：专业领域知识、标准化工作流、可复用资源（模板、脚本、参考文档）。对运维组，很适合沉淀「巡检摘要怎么写」「issue 怎么归类」「变更对照表字段有哪些」这类重复做法。

搜索与安装有几条常见路：

在对话里直接说「帮我找某某技能」，会走查找类能力去匹配开源技能生态。 终端可用 skills 相关 CLI（公开文示例包括 `npx skills find "..."`），关键词写具体比写空泛更准。 安装示例形态是 `npx skills add <owner/repo@skill>`，常见加全局与跳过确认参数；也可直接让 WorkBuddy 在对话里执行安装。 装完用 `ls ~/.workbuddy/skills/` 看目录是否出现，比凭感觉靠谱。

简单任务不必强行装 Skill。WorkBuddy 本身就能做的事，硬套技能只会增加匹配噪音。Skill 适合「同类事反复做、输出结构要稳」的那一类。

写自定义技能时，有两个细节公开文反复强调。

一是 YAML frontmatter 里的 description。它很大程度决定技能被自动匹配的概率。写得越准确越好：适用场景、技术约束、产出类型，尽量写进描述，别只留一个好听的名字。

二是 `agent_created: true`。本地创建时建议带上，否则后续 Agent 可能无法按预期修改这个技能。这是配置项，不是装饰。

公司内网常踩的坑：`npx skills add` 卡在 Cloning repository，最后连不上 github.com:443。防火墙挡住 GitHub 时，代理是一条路；更彻底的是用内置 skill-creator 在本地创建，不依赖外网克隆。

本地创建的公开流程大致是：

对话里说「帮我创建一个技能」，加载 skill-creator。 用初始化脚本在 `~/.workbuddy/skills/` 下生成目录与 SKILL.md（以及示例 scripts / references / assets，不需要就删）。 按「适用场景、核心约束、工作流、验证清单」把 SKILL.md 写清楚。 再 `ls` 验证；相关需求出现时，应能自动加载，也可用 @技能名 手动指定。

适用场景写清楚，模型才知道什么时候该拿起这把斧头。核心约束写清楚，比如「只归纳、不改生产配置」「缺失数据必须显式标注」，能少很多安静的越权。工作流写成可执行步骤，验证清单写成交付前必检项，技能才像组内 SOP，而不像一篇散文。

改已有技能，直接编辑 SKILL.md 即可，下次触发读最新内容。运维组可以把「验收清单」写进技能正文：缺数据源必须标注、禁止生产变更、输出必须落指定目录。比只在群里口头约定靠谱。内网装不上社区技能时，本地创建不是退而求其次，往往是更可控的主路径。

资料库与 Skill 叠在一起时，公开材料里还有几条协作相关提醒，值得 IT 负责人写进内部规范：

优先把最高频来源在资料库接好，跑通后再加自定义 MCP。 协作任务里，个人授权连接器凭据仅存本地、不上云，协作时可能不可用；别假设个人腾讯文档授权能直接支撑所有云端协作任务。 Skill 目录在用户本机路径下，团队推广时要考虑如何分发、如何版本管理，避免每人一份互不兼容的「私房技能」。

腾讯文档解决「原料在云端还要不要搬运」。Skill 解决「做法能不能复用」。小程序和 App 解决「人不在工位能不能下任务」。三件事凑齐，才比较像可管理的 IT 工作方式，而不是个人爽一下的聊天技巧。

本周若只做最小闭环：授权腾讯文档 → 用一句话读一份真实规范出摘要 → 把稳定步骤沉成本地 Skill（写好 description 与验收清单）→ 再试一次小程序远程触发。每一步都能独立验收，出了问题也好定位是通道、做法还是远程链路。

验收时别问「感觉聪不聪明」，问四件具体的事：资料库是否读到了真实文档而不是空摘要；Skill 是否按 description 被正确触发；输出是否落在约定目录；远程任务失败时能否在桌面端看到同一任务记录。四项过关，再谈扩大资料来源或加第二个 Skill。

能力出处：腾讯云开发者社区《WorkBuddy 读取腾讯文档实战》（article/2706799）与《WorkBuddy 技能系统深度指南》（article/2693324）。目录路径、授权项与界面文案以官方文档及当前客户端为准。