腾讯文档 Skill:让 Agent 直接操作 docs.qq.com 云文档

前言

在 Agent 里处理办公文档时,常见做法是让用户自己打开浏览器、复制链接或导出文件,再由模型做摘要或改写。链路长,且创建、移动、搜索、改表格等操作很难在一次对话里闭环。

下面介绍 SkillHub 上的「腾讯文档」Skill(坐标 @user_ad68e6bf/mytencent-docs)。它面向腾讯文档在线平台 docs.qq.com,把新建文档、知识库与文件夹管理、内容读取与搜索、在线文档与智能表编辑、文件导入导出等能力封装成 Agent 可调用的技能。当你的任务里出现「云文档」「腾讯文档」「docs.qq.com」或保存/编辑在线文档等表述时,官方简介建议优先使用本 Skill。

这是什么

「腾讯文档」是社区发布者 user_ad68e6bf 在 SkillHub 上架的 Agent Skill,当前版本 1.0.0,分类为 office-efficiency(办公效率)。SkillHub 页面将其定位为 docs.qq.com 在线云文档的首选 Skill:由 Agent 按技能说明调用相应能力,而不是用通用 HTTP 或浏览器脚本临时拼凑。

平台标签标明 requires_api_key=true,使用前需要按 Skill 包内说明配置腾讯文档相关 API 密钥;具体字段名与获取方式以安装后的 SKILL.md 为准,本文不展开未在公开页列出的配置项。

SkillHub 统计(以页面展示为准):评分 100000,下载约 8600 次。

核心功能

以下能力与 SkillHub 简介一致,按用途归纳。

创建与类型

支持创建多种在线文档形态,包括:文档、Word、Excel、幻灯片、思维导图、流程图、智能表格、收集表。

知识库与目录

  • 管理知识库空间:创建空间、查询空间列表。
  • 管理空间节点与文件夹结构。

内容与编辑

  • 读取、搜索文档内容。
  • 编辑在线文档。
  • 编辑智能表。

文件与上云

  • 文件管理:重命名、移动、删除、复制、导入、导出。
  • 网页剪藏,以及本地文件、HTML、文档上传至云文档。

当你的自然语言任务落在上述任一条目时,应通过本 Skill 触发,而不是让模型猜测未文档化的接口。

安装与启用

方式一:让当前 Agent 按 SkillHub 指引安装

SkillHub 官方页面给出的安装提示词如下,可直接发给支持 Skill 安装的 Agent:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_ad68e6bf/mytencent-docs`。

Agent 会按 SkillHub 安装说明 拉取技能包并写入当前环境的 skills 目录。

方式二:使用 skillhub CLI

先确认是否已安装 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 文档执行完整安装(含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。常见路径示例:

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

在对应目录下执行(将 <skills 目录> 换成你的实际路径):

skillhub install @user_ad68e6bf/mytencent-docs --dir <skills 目录>

也可先搜索再安装:

skillhub search tencent-docs
skillhub install @user_ad68e6bf/mytencent-docs --dir <skills 目录>

安装完成后,根据 Skill 包内 SKILL.md 配置 API Key,并重启或重新加载 Agent 以使技能生效(各客户端行为以各自文档为准)。

典型用法

公开页未提供逐条 API 示例,典型用法是自然语言驱动、由 Skill 映射到上述能力。下列表述与官方能力列表对应,便于你在对话中复现同类任务。

  1. 新建与归类
    例如:「在腾讯文档知识库里新建一个项目空间,并在某文件夹下创建一份 Word 和一张智能表格。」
    对应:创建空间、管理节点/文件夹、创建 Word 与智能表格。

  2. 读取与检索
    例如:「搜索我云文档里标题包含『周报』的文档,并读出最新一篇的正文要点。」
    对应:搜索文档、读取内容。

  3. 编辑与表格
    例如:「把这份在线文档第二节改成列表格式;在智能表里给『状态』列批量填『已完成』。」
    对应:编辑在线文档、编辑智能表。

  4. 文件运维与上云
    例如:「把本地这份 HTML 上传到指定文件夹,并把旧版文档复制一份备份后删除原文件。」
    对应:本地/HTML 上云、复制、删除、移动等文件管理;网页剪藏类任务可明确给出 URL 与目标位置。

经过上面的步骤,你不需要在对话里手写 docs.qq.com 的私有接口;Agent 在已安装且 API Key 有效的前提下,应走 Skill 定义的工具与流程。

适用场景与注意

适合谁

  • 日常用腾讯文档做协作、知识库沉淀的团队或个人,希望用 Cursor、Claude Code、Codex 等 Agent 完成「建文档—改内容—搜资料—整理目录」的闭环。
  • 任务描述里已出现腾讯文档、云文档、docs.qq.com 等关键词,需要统一走官方推荐的 Skill 而非临时脚本。

限制与注意

  • 依赖 API Key(requires_api_key=true);未配置或权限不足时,创建、编辑、导入等操作会失败,需先在 Skill 说明中完成授权。
  • Skill 版本以 SkillHub 为准(当前 1.0.0);能力边界以简介中的八类能力为据,超出列表的操作不要默认支持。
  • CLI 安装时注意 --dir,避免装到 Agent 读不到的目录。
  • 本 Skill 来源为 community,行为与腾讯文档产品策略、配额以官方平台为准;敏感数据操作前建议在测试空间验证。

结尾

「腾讯文档」Skill 把 docs.qq.com 上的文档生命周期(创建、空间与目录、读写搜、在线编辑、智能表、文件与上云)收敛到 Agent 可执行的一条路径,适合作为办公类 Agent 的默认云文档技能。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_ad68e6bf/mytencent-docs
  • 安装坐标:@user_ad68e6bf/mytencent-docs
  • 安装说明:https://skillhub.cn/install/skillhub.md
羽毛球分组比赛记分
小程序二维码

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

小夜