前言¶
團隊數據落在騰訊文檔、飛書或釘釘的在線表格裏時，常見需求是定時把表讀出來、批量寫回、在羣裏推送變更，或把多張表彙總到一張總表。若你習慣用 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
