前言¶
团队数据落在腾讯文档、飞书或钉钉的在线表格里时，常见需求是定时把表读出来、批量写回、在群里推送变更，或把多张表汇总到一张总表。若你习惯用 Microsoft Graph 或 Google Sheets API，会发现国内协作套件走的是另一套开放接口与鉴权方式，脚本和 Agent 往往缺少统一指引。
下面介绍 SkillHub 上的社区 Skill「飞书/腾讯文档/钉钉表格自动化」：用 Python 配合各平台开放 API，把在线表格的读写、同步与推送收敛成 Agent 可执行的工作流，面向「多人实时协作的在线表」，而不是本地 xlsx 文件处理。
这是什么¶
一句话定位：基于 Python 与飞书、腾讯文档、钉钉开放 API 的在线表格自动化 Skill，覆盖批量读写、定时同步、机器人推送与跨表合并；SkillHub 简介将其定位为国产场景下替代 Microsoft Graph 的完整方案。
出品与坐标：社区来源（community），发布者 user_36c7efa2，Skill 坐标 @user_36c7efa2/tencent-docs-flow，当前版本 1.0.0，分类为 office-efficiency（办公效率）。
解决什么问题：把「要在协作表格里自动改数、拉数、通知人」这类任务，交给已安装该 Skill 的 AI Agent，由 Skill 内的说明与流程约束调用方式，减少从零查三家文档的成本。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取资料中的简介，未单独列出的能力不写进正文。
- 批量读写：通过各平台表格相关开放 API，对在线表格进行批量读取与写入。
- 定时同步：支持按时间策略在数据源与目标表之间同步（具体 cron 或调度方式以安装后的 Skill 文档为准）。
- 机器人推送：结合飞书、钉钉等侧的机器人能力，把表格相关消息推到团队群（需平台侧机器人与权限配置）。
- 跨表合并：在多张在线表之间做汇总、合并类操作。
Skill 标签标明 requires_api_key=true：使用前需要在对应开放平台申请应用凭证，并在环境中配置 API Key / 应用密钥等，否则无法调用接口。
安装与启用¶
安装方式以 SkillHub 官方说明为准：先按 SkillHub 安装与优先源配置 准备 skillhub CLI，再把本 Skill 装到当前 Agent 实际使用的 skills 目录（未指定 --dir 时默认装到 ./skills/，多数客户端不会自动加载）。
1、检查是否已安装 CLI
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装或仅 CLI 安装（见 skillhub.cn/install/skillhub.md 中的 curl 命令）。
2、安装本 Skill
页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_36c7efa2/tencent-docs-flow。
命令行示例（将 <skills 目录> 换成你当前环境的路径）：
skillhub install user_36c7efa2/tencent-docs-flow --dir <skills 目录>
常见客户端 skills 目录（摘自官方安装文档，以你本机为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中把上述安装提示发给 AI，让其按 skillhub.md 完成安装。
3、配置开放平台凭证
因 requires_api_key=true，需在腾讯文档、飞书或钉钉开发者后台创建应用，开通表格与机器人等相关权限，并把密钥配置到 Skill 或项目要求的环境变量中。三家平台的应用类型、回调与权限范围互不相同，按你实际选用的平台逐项开通。
安装完成后，重启或刷新 Agent 的 Skill 加载，使 tencent-docs-flow 生效。
典型用法¶
官方页面未附带独立可复制的端到端代码仓库链接；典型用法是：安装 Skill 后，用自然语言描述目标表平台与操作，由 Agent 按 Skill 内 SKILL.md 的约定选择 Python 脚本与对应开放 API。
可复现的交互示例（表述需与你环境中的表名、文档 ID 一致）：
- 「用腾讯文档 API 读取某张在线表指定范围，导出为结构化数据。」
- 「定时把 A 表增量同步到 B 表（飞书多维表格 / 电子表格，以你实际产品为准）。」
- 「钉钉表格数据更新后，通过群机器人推送摘要。」
- 「把多个部门的在线表按主键合并到一张总表。」
实现细节（接口路径、分页、限流、OAuth）以各平台当前开放文档为准；本 Skill 的价值在于把三类国产套件纳入同一套 Agent 工作流，而不是替代官方文档。
适用场景与注意¶
适合谁
- 数据在腾讯文档、飞书或钉钉在线表格中维护，需要脚本化或 Agent 化批量处理。
- 需要群机器人与表格联动，或跨多张协作表汇总。
- 希望在国内协作栈里做类似 Microsoft Graph / Google Sheets API 的自动化，而不想每次从零拼接口。
触发表述（便于 Agent 匹配本 Skill）
用户提到「自动同步腾讯文档」「飞书表格 API」「钉钉表格机器人」「跨平台表格汇总」「在线表格自动化」「协作表格 API」等时，可优先启用本 Skill。
限制与注意
- 社区 Skill，维护节奏取决于发布者；版本以 SkillHub 显示的 1.0.0 为准。
- 必须自备各平台 API 凭证与合规的应用审核；生产环境注意频率限制与数据权限。
- 与「本地 xlsx 读写」类 Skill 分工不同：本 Skill 专攻在线协作表格，不适合作为离线 Excel 文件的主方案。
- SkillHub 统计（以已抓取资料为准）：评分 100000，下载 3652；安装次数在抓取时点为 0，仅作商店参考，不代表可用性。
结尾¶
「飞书/腾讯文档/钉钉表格自动化」把国产三大协作表格的开放 API 自动化收敛到 SkillHub 上的一个坐标，适合需要批量读写、定时同步、机器人推送与跨表合并的在线表场景。安装与凭证配置完成后，用明确平台与表操作描述驱动 Agent 即可。
- SkillHub 页面：https://www.skillhub.cn/skills/user_36c7efa2/tencent-docs-flow
- API 条目：https://api.skillhub.cn/user_36c7efa2/tencent-docs-flow
