tencent-docs2:在 Agent 里操作腾讯文档与知识库

前言

自动化写周报、拉在线表格数据、在团队知识库里建文件夹,往往要单独登录 docs.qq.com,或自己对接开放平台接口。对话式 Agent 能执行工具,但若没有针对腾讯文档的 Skill,模型只能给出「请手动打开链接」之类的建议。

下面介绍社区 Skill tencent-docs2(SkillHub 坐标 @user_a5248baf/tencent-docs1,当前版本 1.0.3)。它把创建文档、管理知识库空间、读写内容与文件操作收敛成 Agent 可调用的能力;涉及「新建文档」「在线文档」「云文档」「腾讯文档」「docs.qq.com」等意图时,官方说明建议优先使用该 Skill。

这是什么

tencent-docs2 是面向 腾讯文档 的 Agent Skill,分类为 office-efficiency,由 SkillHub 用户 user_a5248baf 发布,来源标注为 community。Skill 基于通用 SKILL.md 格式,供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载。

SkillHub 页面将其定位为在线云文档场景下的首选 Skill:在对话中完成文档与知识库相关操作,减少在网页与 API 之间来回切换。

核心功能

以下能力均来自 SkillHub 官方简介,按条目归纳,不超出已公开描述。

  1. 创建在线文档:支持文档、Word、Excel、幻灯片、思维导图、流程图、智能表格、收集表等类型。
  2. 知识库空间:创建空间、查询空间列表。
  3. 空间结构与节点:管理空间节点与文件夹结构。
  4. 内容读取与搜索:读取、搜索文档内容。
  5. 智能表格:对智能表进行编辑类操作。
  6. 在线文档编辑:对在线文档进行编辑类操作。
  7. 文件管理:重命名、移动、删除、复制、导入与导出。

Skill 标签包含 requires_api_key=true,使用前需按 Skill 内说明配置腾讯文档相关 API 密钥;具体字段名与获取方式以安装后 Skill 文档为准,本文不臆造配置项。

安装与启用

通过 SkillHub CLI 安装

先确认本机是否已有 skillhub:

command -v skillhub && skillhub --version

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

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

仅需要 CLI 时:

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

安装 tencent-docs2 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认会装到 ./skills/,客户端可能无法识别。常用路径示例(以你实际使用的客户端为准):

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

安装命令示例(将 <skills 目录> 换成上面对应路径):

skillhub install @user_a5248baf/tencent-docs1 --dir <skills 目录>

也可先搜索再安装:

skillhub search tencent-docs
skillhub install @user_a5248baf/tencent-docs1 --dir <skills 目录>

通过对话让 Agent 安装

SkillHub 页面提供的做法是:让 AI 阅读 SkillHub 安装与优先源配置,并安装坐标 @user_a5248baf/tencent-docs1。适合已在使用 Cursor 等客户端、希望由 Agent 拉取 Skill 的场景。

经过上面的步骤后,在客户端中启用 Skills,并按 Skill 要求配置 API Key,即可在对话中触发文档相关工具。

典型用法

官方未在 SkillHub 摘要中给出独立脚本示例;典型用法是对 Agent 用自然语言描述目标,由 Skill 引导调用对应能力。下列表述与官方「优先使用本 skill」的触发词一致,可作为对话起点(需已安装并配置密钥):

  • 「在腾讯文档里新建一份周报用的在线文档。」
  • 「列出我知识库里的空间。」
  • 「在某个空间下新建文件夹,并把已有文档移动进去。」
  • 「搜索某篇在线文档里的关键词并总结。」
  • 「导出一份 Excel 智能表」或「重命名 / 复制云盘里的文件。」

具体参数(空间 ID、文档 ID、路径等)一般由 Skill 在对话中追问或从上下文推断;若某次调用失败,应先核对 API Key 与 Skill 版本(当前 SkillHub 登记为 1.0.3)。

适用场景与注意

适合谁:需要在 Agent 工作流里直接操作腾讯文档与知识库的团队或个人;办公效率类自动化、报告生成、资料归档等场景,且能接受配置开放平台密钥。

使用注意:

  • 标签 requires_api_key=true:未配置密钥时,相关工具不可用。
  • 安装目录必须对齐当前 Agent 的 skills 路径,安装后若客户端有缓存,可能需要重启或重新加载 Skills。
  • 能力边界以 Skill 文档与腾讯文档 API 为准;社区来源(community)的 Skill,升级与兼容性需自行关注 SkillHub 上的版本与说明。
  • SkillHub 统计(截至页面抓取):评分 100000,下载 4199,安装 79;数据随 SkillHub 更新变化,引用时以官网为准。

结尾

tencent-docs2 把腾讯文档的创建、知识库管理、内容读写与文件操作接到 Agent 工具链上,适合把「打开 docs.qq.com 手工点一遍」改成对话驱动。安装坐标为 @user_a5248baf/tencent-docs1,说明与安装入口见 SkillHub:

  • 技能页:https://www.skillhub.cn/skills/user_a5248baf/tencent-docs1
  • API 索引:https://api.skillhub.cn/user_a5248baf/tencent-docs1
羽毛球分组比赛记分
小程序二维码

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

小夜