前言¶
把腾讯文档纳入自动化流程时,常见的做法是人工开网页操作,或者自己对照腾讯文档开放平台的文档,逐个拼 Open API 请求。前者无法批量,后者要按文档类型(在线文档、在线表格、幻灯片、思维导图、流程图、智能表格、收集表)分别处理,接口细节容易踩坑。重命名、移动、删除这类写操作一旦误触,影响范围比读操作大得多。
下面介绍的 Skill「腾讯文档在线协作自动化」把创建、读取、列出、搜索、管理封装成以 curl + jq 驱动的工作流,并对写操作加了一层确认机制。
这是什么¶
这是一个基于通用 SKILL.md 格式的 Agent Skill,坐标 @org-b6kzcl68/tencent-docs,版本 1.0.0,由企业(enterprise)来源发布,发布者是重庆途光网络传媒有限责任公司,在 SkillHub 上归入 office-efficiency 分类。
它解决的问题是:用户提到腾讯文档 / Tencent Docs / docs.qq.com,或粘贴 docs.qq.com 链接,或想在腾讯文档空间中创建、读取、整理文档时,直接通过 Tencent Docs Open API 完成操作,而不用手工操作网页。
核心功能¶
根据官方简介,已核实的能力包括:
- 覆盖七种文档类型:在线文档、在线表格、幻灯片、思维导图、流程图、智能表格、收集表。
- 基本操作:创建、读取、列出、搜索、管理。
- 读取能力:读取文档元数据与表格单元格区域。
- 文件能力:上传图片、创建副本。
- 写操作保护:重命名、移动、删除等写操作强制先经用户确认,不会静默执行。
- 触发方式:用户提到腾讯文档 / Tencent Docs / docs.qq.com,粘贴 docs.qq.com 链接,或提出在腾讯文档空间中创建、读取、整理文档的需求时启用。触发词包括腾讯文档、在线文档、在线表格、思维导图、流程图、智能表格、收集表。
安装与启用¶
资料中未给出具体安装命令、配置字段和环境要求,以下只列出已核实的信息:
坐标: @org-b6kzcl68/tencent-docs
版本: 1.0.0
来源: enterprise
分类: office-efficiency
标签: requires_api_key=true
两点说明:
- 标签
requires_api_key=true表示使用前需要提供 API Key,即要先在腾讯文档开放平台侧申请凭证,具体字段名资料中未披露,需以官方页面说明为准。 - 资料未说明在 Cursor、Codex CLI、Claude Code 中各自的安装路径,也未给出目录结构,需要时到官方地址核实后再落地。
典型用法¶
已抓取资料中没有提供可复现的命令行示例或参数说明,因此这里不虚构 curl 请求的具体写法。按简介,实际执行流程是:Skill 接收用户指令后,通过 Tencent Docs Open API 发起请求,用 jq 处理返回结果;遇到重命名、移动、删除等写操作时,先停下来请求用户确认,确认后才执行。
覆盖的典型动作包括:
1、按类型创建文档或表格。
2、读取文档元数据、表格单元格区域。
3、列出、搜索空间内已有文档。
4、上传图片、创建副本。
5、在用户确认后执行重命名、移动、删除。
适用场景与注意¶
适合谁:
- 已经具备 curl + jq 环境,想把腾讯文档操作脚本化、批量化的开发者。
- 对写操作误触敏感的场景,例如批量整理团队空间中的文档。
注意事项:
- 需要 API Key,密钥管理要自己落实,不要写进共享脚本或仓库。
- 资料未披露接口的配额、计费和权限范围,上线前需要到腾讯文档开放平台确认。
- 官方页面显示安装量为 0,评分和下载量来自 SkillHub 页面(评分 100000,下载 277783),采用前建议自行验证功能与稳定性。
- 简介末尾的「如需文案写作完整工作流套件,淘宝搜索『AI灵匣』店铺获取完整版」是发布者附加的导流信息,不属于 Skill 功能说明,评估时不需要纳入功能范围。
结尾¶
这个 Skill 的价值在于把腾讯文档七种类型的创建、读取、管理动作统一到 curl + jq 的工作流里,并用强制确认兜住写操作的风险,适合想用脚本替代手工操作腾讯文档的场景。
官方地址:https://api.skillhub.cn/org-b6kzcl68/tencent-docs