前言¶
在对话里让模型「写一份在线文档」「在知识库里建文件夹」「改智能表里的数据」，如果只靠通用网页抓取或手写脚本，往往要对齐腾讯文档的页面结构，还要自己处理登录与权限。团队文档已经落在 docs.qq.com 时，更希望 Agent 能按统一 Skill 去创建、读写和管理，而不是每次临时拼凑方案。
下面介绍 SkillHub 上的 腾讯文档编辑技能（坐标 @user_a5827f21/tencent-works）。它面向腾讯文档在线云文档平台，把新建文档、空间与节点管理、内容读取搜索、在线文档与智能表编辑、文件导入导出等能力封装成 Agent 可调用的 Skill；当用户意图涉及「新建文档」「创建文档」「写文档」「在线文档」「云文档」「腾讯文档」「docs.qq.com」等表述时，官方说明建议优先使用本 Skill。
这是什么¶
腾讯文档编辑技能 是社区来源（community）的 office-efficiency 类 Skill，当前版本 1.0.1，由 SkillHub 用户 user_a5827f21 发布；SkillHub 页面标注作者为盛通教育-张维。Skill 基于通用 SKILL.md 格式，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载后，由模型按 Skill 内指引调用腾讯文档相关能力。
它解决的核心问题是：在 Agent 工作流里，用一套固定技能边界对接腾讯文档，而不是为每种文档类型单独写集成代码。
核心功能¶
以下能力与 SkillHub 简介及官方页面描述一致，按能力域归纳。
创建在线文档¶
支持创建多种在线文档类型，包括：文档、Word、Excel、幻灯片、思维导图、流程图、智能表格、收集表。
知识库与目录结构¶
- 管理知识库空间：创建空间、查询空间列表。
- 管理空间节点与文件夹结构。
内容与编辑¶
- 读取、搜索文档内容。
- 编辑操作智能表。
- 编辑操作在线文档。
文件管理¶
重命名、移动、删除、复制，以及导入、导出。
安装与启用¶
前置：SkillHub CLI¶
若本机尚未安装 SkillHub CLI，可先按 SkillHub 安装说明 检查或安装：
command -v skillhub && skillhub --version
未安装时，可使用文档中的完整安装命令（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
官方页面给出的安装方式是：让 AI 根据 https://skillhub.cn/install/skillhub.md 安装坐标 @user_a5827f21/tencent-works。
手动安装时，需用 --dir 指向当前 Agent 实际使用的 skills 目录（装到错误目录会导致客户端无法识别）。SkillHub 文档中常见路径示例：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 替换为上表对应路径）：
skillhub install user_a5827f21/tencent-works --dir <skills 目录>
也可将下面提示词发给已支持 Skill 安装的 AI，由其按安装文档完成配置：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_a5827f21/tencent-works。
API Key¶
SkillHub 标签标明 requires_api_key=true，即启用本 Skill 通常需要配置腾讯文档/Open 相关 API 密钥。具体环境变量名、申请入口与权限范围以 Skill 包内 SKILL.md 及腾讯文档开放平台文档为准；本文未在公开页面核对到字段名，不在此处臆造配置项。
安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 被加载。
典型用法¶
公开页面未附带逐步复制的 CLI 或 HTTP 示例，典型用法应结合 Skill 安装后的对话意图与 SKILL.md 中的工具说明。从已公布能力可归纳如下工作方式（表述为操作意图，而非虚构接口名）：
- 新建与归类：在指定知识库空间或文件夹下创建文档、表格、幻灯片等类型文件。
- 检索与阅读：按关键词或路径搜索并读取在线文档内容，供 Agent 总结、改写或引用。
- 结构化编辑：对智能表增删改查记录；对在线文档执行 Skill 支持的编辑操作。
- 资产整理：重命名、移动、复制、删除节点，或在需要时执行导入、导出。
在 Cursor 等环境中，用户可直接用自然语言描述上述意图；模型在已加载本 Skill 且 API 配置正确的前提下，应优先走 Skill 定义的工具链，而不是临时编写未维护的爬虫脚本。
适用场景与注意¶
适合谁
- 日常协作文档托管在腾讯文档、希望 Agent 能创建和管理在线文档的团队或个人。
- 需要在知识库中维护目录结构，并由 Agent 批量整理、搜索、更新内容的场景。
- 智能表、收集表与在线文档混合使用，希望统一从一个 Skill 入口操作的情况。
使用注意
- 必须满足 API Key 与账号权限要求；无密钥或权限不足时，Skill 无法真正改动云端资源。
- Skill 版本以 SkillHub 为准（当前 1.0.1）；升级可用
skillhub的更新流程，并再次指定正确的--dir。 - SkillHub 统计（截至资料抓取）：评分 100000，下载 3492 次；数据来自 SkillHub 元数据，会随时间变化。
- 本 Skill 为社区发布，集成行为与腾讯文档官方 API 变更相关；遇接口或权限问题时，应对照 Skill 包内说明与腾讯文档官方文档排查。
结尾¶
腾讯文档编辑技能把 docs.qq.com 上的文档创建、知识库与文件夹管理、内容读写、智能表与在线文档编辑以及文件管理能力收敛到一个 Skill 坐标 @user_a5827f21/tencent-works，适合作为 Agent 处理腾讯文档相关意图时的首选技能。安装与优先源配置见 SkillHub 安装说明；Skill 详情页见 SkillHub：腾讯文档编辑技能，API 入口为 https://api.skillhub.cn/user_a5827f21/tencent-works。
