前言¶
在 Agent 裏處理辦公文檔時,常見做法是讓用戶自己打開瀏覽器、複製鏈接或導出文件,再由模型做摘要或改寫。鏈路長,且創建、移動、搜索、改表格等操作很難在一次對話裏閉環。
下面介紹 SkillHub 上的「騰訊文檔」Skill(座標 @user_ad68e6bf/mytencent-docs)。它面向騰訊文檔在線平臺 docs.qq.com,把新建文檔、知識庫與文件夾管理、內容讀取與搜索、在線文檔與智能表編輯、文件導入導出等能力封裝成 Agent 可調用的技能。當你的任務裏出現「雲文檔」「騰訊文檔」「docs.qq.com」或保存/編輯在線文檔等表述時,官方簡介建議優先使用本 Skill。
這是什麼¶
「騰訊文檔」是社區發佈者 user_ad68e6bf 在 SkillHub 上架的 Agent Skill,當前版本 1.0.0,分類爲 office-efficiency(辦公效率)。SkillHub 頁面將其定位爲 docs.qq.com 在線雲文檔的首選 Skill:由 Agent 按技能說明調用相應能力,而不是用通用 HTTP 或瀏覽器腳本臨時拼湊。
平臺標籤標明 requires_api_key=true,使用前需要按 Skill 包內說明配置騰訊文檔相關 API 密鑰;具體字段名與獲取方式以安裝後的 SKILL.md 爲準,本文不展開未在公開頁列出的配置項。
SkillHub 統計(以頁面展示爲準):評分 100000,下載約 8600 次。
核心功能¶
以下能力與 SkillHub 簡介一致,按用途歸納。
創建與類型¶
支持創建多種在線文檔形態,包括:文檔、Word、Excel、幻燈片、思維導圖、流程圖、智能表格、收集表。
知識庫與目錄¶
- 管理知識庫空間:創建空間、查詢空間列表。
- 管理空間節點與文件夾結構。
內容與編輯¶
- 讀取、搜索文檔內容。
- 編輯在線文檔。
- 編輯智能表。
文件與上雲¶
- 文件管理:重命名、移動、刪除、複製、導入、導出。
- 網頁剪藏,以及本地文件、HTML、文檔上傳至雲文檔。
當你的自然語言任務落在上述任一條目時,應通過本 Skill 觸發,而不是讓模型猜測未文檔化的接口。
安裝與啓用¶
方式一:讓當前 Agent 按 SkillHub 指引安裝¶
SkillHub 官方頁面給出的安裝提示詞如下,可直接發給支持 Skill 安裝的 Agent:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_ad68e6bf/mytencent-docs`。
Agent 會按 SkillHub 安裝說明 拉取技能包並寫入當前環境的 skills 目錄。
方式二:使用 skillhub CLI¶
先確認是否已安裝 CLI:
command -v skillhub && skillhub --version
未安裝時,可按 SkillHub 文檔執行完整安裝(含 CLI 與默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時,必須用 --dir 指向當前 Agent 的 skills 目錄,否則默認落在 ./skills/ 可能不會被識別。常見路徑示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
在對應目錄下執行(將 <skills 目錄> 換成你的實際路徑):
skillhub install @user_ad68e6bf/mytencent-docs --dir <skills 目錄>
也可先搜索再安裝:
skillhub search tencent-docs
skillhub install @user_ad68e6bf/mytencent-docs --dir <skills 目錄>
安裝完成後,根據 Skill 包內 SKILL.md 配置 API Key,並重啓或重新加載 Agent 以使技能生效(各客戶端行爲以各自文檔爲準)。
典型用法¶
公開頁未提供逐條 API 示例,典型用法是自然語言驅動、由 Skill 映射到上述能力。下列表述與官方能力列表對應,便於你在對話中復現同類任務。
-
新建與歸類
例如:「在騰訊文檔知識庫裏新建一個項目空間,並在某文件夾下創建一份 Word 和一張智能表格。」
對應:創建空間、管理節點/文件夾、創建 Word 與智能表格。 -
讀取與檢索
例如:「搜索我雲文檔裏標題包含『週報』的文檔,並讀出最新一篇的正文要點。」
對應:搜索文檔、讀取內容。 -
編輯與表格
例如:「把這份在線文檔第二節改成列表格式;在智能表裏給『狀態』列批量填『已完成』。」
對應:編輯在線文檔、編輯智能表。 -
文件運維與上雲
例如:「把本地這份 HTML 上傳到指定文件夾,並把舊版文檔複製一份備份後刪除原文件。」
對應:本地/HTML 上雲、複製、刪除、移動等文件管理;網頁剪藏類任務可明確給出 URL 與目標位置。
經過上面的步驟,你不需要在對話裏手寫 docs.qq.com 的私有接口;Agent 在已安裝且 API Key 有效的前提下,應走 Skill 定義的工具與流程。
適用場景與注意¶
適合誰
- 日常用騰訊文檔做協作、知識庫沉澱的團隊或個人,希望用 Cursor、Claude Code、Codex 等 Agent 完成「建文檔—改內容—搜資料—整理目錄」的閉環。
- 任務描述裏已出現騰訊文檔、雲文檔、docs.qq.com 等關鍵詞,需要統一走官方推薦的 Skill 而非臨時腳本。
限制與注意
- 依賴 API Key(
requires_api_key=true);未配置或權限不足時,創建、編輯、導入等操作會失敗,需先在 Skill 說明中完成授權。 - Skill 版本以 SkillHub 爲準(當前 1.0.0);能力邊界以簡介中的八類能力爲據,超出列表的操作不要默認支持。
- CLI 安裝時注意
--dir,避免裝到 Agent 讀不到的目錄。 - 本 Skill 來源爲 community,行爲與騰訊文檔產品策略、配額以官方平臺爲準;敏感數據操作前建議在測試空間驗證。
結尾¶
「騰訊文檔」Skill 把 docs.qq.com 上的文檔生命週期(創建、空間與目錄、讀寫搜、在線編輯、智能表、文件與上雲)收斂到 Agent 可執行的一條路徑,適合作爲辦公類 Agent 的默認雲文檔技能。
- SkillHub 頁面:https://www.skillhub.cn/skills/user_ad68e6bf/mytencent-docs
- 安裝座標:
@user_ad68e6bf/mytencent-docs - 安裝說明:https://skillhub.cn/install/skillhub.md