前言¶
在對話裏讓模型「寫一份在線文檔」「在知識庫裏建文件夾」「改智能表裏的數據」，如果只靠通用網頁抓取或手寫腳本，往往要對齊騰訊文檔的頁面結構，還要自己處理登錄與權限。團隊文檔已經落在 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。
