tencent-docs:腾讯文档的云端文档操作 Skill

前言

在 Agent 里处理文档时,常见的做法是让模型生成一段文本,用户自己去网页端新建文档、粘贴、调整结构。这条路能跑通,但把「创建—编辑—归档」的链路切成了两段:模型产出内容,人去执行操作。对于需要批量建表、维护知识库结构、把本地文件上云的流程,人工介入的成本会反复累积。

tencent-docs 这个 Skill 把这条链路收拢到一个接口集合里。下面介绍它覆盖哪些能力、怎么启用、适合什么场景。

这是什么

tencent-docs 是一个面向腾讯文档(docs.qq.com)的 Agent Skill,作用是让 Agent 直接调用腾讯文档平台的能力:创建在线文档、管理知识库空间与节点、读取和搜索文档内容、编辑智能表和在线文档、做文件管理与内容上云。

发布者是 user_6ea2d2ec,坐标 @user_6ea2d2ec/tencent-docs-v2,版本 1.0.0,来源标记为 community,分类是 office-efficiency。Skill 带有 requires_api_key=true 标签,说明启用前需要准备好对应的凭据。

它解决的问题是:当任务里出现「新建/创建/编辑/读取/查看/搜索文档」「保存文件」「云文档」「腾讯文档」「docs.qq.com」这类关键词时,Agent 不必退化成生成文本让用户手动粘贴,而是直接走平台能力完成操作。

核心功能

根据 SkillHub 页面给出的简介,支持的能力分八项:

  1. 创建各类在线文档,覆盖文档/Word/Excel/幻灯片/思维导图/流程图/智能表格/收集表。
  2. 管理知识库空间,包括创建空间、查询空间列表。
  3. 管理空间节点和文件夹结构。
  4. 读取和搜索文档内容。
  5. 编辑操作智能表。
  6. 编辑操作在线文档。
  7. 文件管理,包括重命名、移动、删除、复制、导入导出。
  8. 网页剪藏,以及本地文件/html/文档上云。

前四项偏「读」和「建结构」,后四项偏「写」和「维护」。对需要长期维护一套文档库的流程来说,第 2、3 项(空间与节点)比单篇文档的增删更关键,因为它决定了文档落在哪里。

安装与启用

已抓取的资料中只包含 Skill 的坐标、版本、来源和标签,没有列出具体的安装命令或配置文件路径,因此这里不给出未经核实的命令。

启用前需要确认两件事:

  1. 准备好腾讯文档开放平台对应的 API Key,对应 Skill 标签里的 requires_api_key=true。
  2. 在所使用的 Agent 环境里按该环境的 Skill 安装流程引入 @user_6ea2d2ec/tencent-docs-v2,具体步骤以 SkillHub 页面当时的说明为准。

不同 Agent 环境(Cursor、Codex CLI、Claude Code 等)对 Skill 的加载方式不一致,已抓取资料里没有区分说明,需要时到官方页面核对。

典型用法

Skill 的触发方式是关键词驱动。当任务表述里出现「新建文档」「搜索云文档」「把这份表格存到腾讯文档」「剪藏这个网页」等意图时,Agent 会优先使用本 Skill 而不是退化为文本生成。

几个可以直接对应到能力项的用法:

  • 需要批量产出收集表或智能表时,走第 1 项和第 5 项,先建表再写入数据。
  • 需要把散落的文档整理进知识库时,走第 2、3 项,先建空间,再建节点,最后移动文档。
  • 需要从已有文档里取内容做摘要或检索时,走第 4 项。
  • 需要把本地 markdown、html 或文档文件同步到云端时,走第 8 项。

适用场景与注意

适合的场景:文档库需要长期维护、操作批量化、希望 Agent 端到端完成创建到归档的流程。第 7 项的文件管理(重命名、移动、删除、复制)在这类流程里用得最多。

需要注意的限制:

  1. Skill 来源是 community,不是官方维护,使用前确认发布者与更新情况。
  2. 评分和下载量属于平台展示数据,不反映具体文档类型的支持完整度,特别是思维导图、流程图这类结构型文档,实际效果需要在启用后验证。
  3. 涉及删除、移动等不可逆操作时,建议先在测试空间验证节点结构,再对正式知识库执行。
  4. 网页剪藏依赖目标页面的可抓取性,部分需要登录或有反爬策略的页面可能失败。

结尾

tencent-docs 的价值在于把腾讯文档平台的操作能力封装成 Agent 可直接调用的一组动作,省掉人工在网页端来回切换的环节。如果工作流里有大量建表、归档、上云的需求,值得先在一个测试空间里跑通再铺开。

官方地址:https://api.skillhub.cn/user_6ea2d2ec/tencent-docs-v2

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜