23123:在 Agent 里对接腾讯文档(docs.qq.com)

前言

在 Agent 工作流里处理「新建文档」「写在线文档」「整理知识库」时,若只靠通用工具去拼网页操作或手写 Open API,成本高且容易漏步骤。腾讯文档(docs.qq.com)本身提供完整的在线云文档与知识库能力;若希望 Agent 在对话中稳定完成创建、读写、目录与文件管理,需要一套与产品语义对齐的 Skill 指引。

下面介绍 SkillHub 社区 Skill「23123」:坐标 @user_7e25a48a/1234123,版本 1.0.0,分类为 office-efficiency。官方说明将其定位为涉及腾讯文档、云文档、docs.qq.com 等场景时的优先 Skill。

这是什么

「23123」是基于通用 SKILL.md 格式的 Agent Skill,由 SkillHub 用户 user_7e25a48a(页面展示作者为 yazi测试账号)发布,来源为 community。它面向腾讯文档在线云文档平台,把「建文档、管空间、读内容、改智能表/在线文档、做文件运维」等能力收敛到同一套 Skill 说明里,供 Cursor、Claude Code、Codex 等支持 Skills 的客户端在识别用户意图后按文档调用。

SkillHub 页面标签为 requires_api_key=true,意味着启用前需要自行准备并完成 API 密钥相关配置(具体字段以安装后技能目录内的 SKILL.md 为准)。

核心功能

以下能力均来自 SkillHub 官方简介,未在资料中出现的接口名或参数不在此展开。

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

当用户表述中出现「新建文档」「创建文档」「写文档」「在线文档」「云文档」「腾讯文档」「docs.qq.com」等意图时,官方建议优先使用本 Skill,而不是让 Agent 临时猜测网页或 API 流程。

安装与启用

SkillHub 提供统一安装说明:https://skillhub.cn/install/skillhub.md。页面给出的安装提示为:请根据该文档安装 @user_7e25a48a/1234123。

1、安装 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

2、安装本 Skill 到当前 Agent 的 skills 目录

安装技能时必须用 --dir 指向当前客户端识别的 skills 目录,否则默认落在 ./skills/ 可能不会被 Agent 加载。SkillHub 文档中常见路径示例:

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

安装命令形式如下(将 <skills 目录> 替换为实际路径):

skillhub install @user_7e25a48a/1234123 --dir <skills 目录>

也可在支持 Skills 的客户端中,将官方提示词发给 Agent,由其按 https://skillhub.cn/install/skillhub.md 完成安装。

3、API 密钥与重启

因标签 requires_api_key=true,安装后应打开技能目录内的 SKILL.md,按说明配置腾讯文档相关 API 密钥。部分客户端在安装或改配置后需要重启或重新加载技能目录,具体以你所用客户端文档为准;SkillHub 安装说明对「装错目录需重启」有单独提醒。

典型用法

公开资料未附带逐条可复制的 API 调用示例,典型用法应围绕官方列出的能力域,用自然语言向 Agent 描述目标,并显式提及腾讯文档或本 Skill 坐标,例如:

  • 「在腾讯文档里新建一份智能表格,并放到指定知识库文件夹下。」
  • 「列出我有权限的知识库空间,在某个空间里搜索包含某关键词的文档。」
  • 「读取某在线文档正文摘要,或对已有智能表追加一行记录。」
  • 「把某文件重命名并移动到另一文件夹,或导出为指定格式。」

Agent 在已加载 @user_7e25a48a/1234123 且 API 配置正确的前提下,应按 SKILL.md 中的步骤选择对应工具或流程,而不是自行编造未文档化的接口。

适用场景与注意

适合谁

  • 需要在 Agent 对话中频繁创建、编辑、整理腾讯文档与知识库的团队或个人。
  • 希望把「云文档 + 空间 + 文件运维」统一交给同一 Skill,减少意图识别偏差。

使用注意

  • 本 Skill 为社区来源(community),行为与限制以 SKILL.md 及腾讯文档平台规则为准。
  • 必须配置 API 密钥;权限范围取决于密钥与账号在 docs.qq.com 上的授权。
  • SkillHub 统计(抓取时):评分 100000,下载 718,安装 9;页面数据会变动,以 SkillHub 实时展示为准。
  • 未在官方简介中声明的能力(例如未列出的第三方集成)不要默认支持。

结尾

「23123」把腾讯文档从「偶尔手动点开网页」变成 Agent 可编排的办公能力集:建多类型文档、管知识库与目录、读搜内容、改智能表与在线文档、做文件级运维。若你的工作流里经常出现 docs.qq.com 相关操作,可通过 SkillHub 安装 @user_7e25a48a/1234123 并配置 API 后使用。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_7e25a48a/1234123
  • API 资源地址:https://api.skillhub.cn/user_7e25a48a/1234123
羽毛球分组比赛记分
小程序二维码

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

Xiaoye