前言¶
自動化寫週報、拉在線表格數據、在團隊知識庫裏建文件夾,往往要單獨登錄 docs.qq.com,或自己對接開放平臺接口。對話式 Agent 能執行工具,但若沒有針對騰訊文檔的 Skill,模型只能給出「請手動打開鏈接」之類的建議。
下面介紹社區 Skill tencent-docs2(SkillHub 座標 @user_a5248baf/tencent-docs1,當前版本 1.0.3)。它把創建文檔、管理知識庫空間、讀寫內容與文件操作收斂成 Agent 可調用的能力;涉及「新建文檔」「在線文檔」「雲文檔」「騰訊文檔」「docs.qq.com」等意圖時,官方說明建議優先使用該 Skill。
這是什麼¶
tencent-docs2 是面向 騰訊文檔 的 Agent Skill,分類爲 office-efficiency,由 SkillHub 用戶 user_a5248baf 發佈,來源標註爲 community。Skill 基於通用 SKILL.md 格式,供 Cursor、Claude Code、Codex 等支持 Skills 的客戶端加載。
SkillHub 頁面將其定位爲在線雲文檔場景下的首選 Skill:在對話中完成文檔與知識庫相關操作,減少在網頁與 API 之間來回切換。
核心功能¶
以下能力均來自 SkillHub 官方簡介,按條目歸納,不超出已公開描述。
- 創建在線文檔:支持文檔、Word、Excel、幻燈片、思維導圖、流程圖、智能表格、收集表等類型。
- 知識庫空間:創建空間、查詢空間列表。
- 空間結構與節點:管理空間節點與文件夾結構。
- 內容讀取與搜索:讀取、搜索文檔內容。
- 智能表格:對智能表進行編輯類操作。
- 在線文檔編輯:對在線文檔進行編輯類操作。
- 文件管理:重命名、移動、刪除、複製、導入與導出。
Skill 標籤包含 requires_api_key=true,使用前需按 Skill 內說明配置騰訊文檔相關 API 密鑰;具體字段名與獲取方式以安裝後 Skill 文檔爲準,本文不臆造配置項。
安裝與啓用¶
通過 SkillHub CLI 安裝¶
先確認本機是否已有 skillhub:
command -v skillhub && skillhub --version
未安裝時,可按 SkillHub 安裝說明執行完整安裝(CLI 與默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需要 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝 tencent-docs2 時,必須用 --dir 指向當前 Agent 的 skills 目錄,否則默認會裝到 ./skills/,客戶端可能無法識別。常用路徑示例(以你實際使用的客戶端爲準):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
安裝命令示例(將 <skills 目錄> 換成上面對應路徑):
skillhub install @user_a5248baf/tencent-docs1 --dir <skills 目錄>
也可先搜索再安裝:
skillhub search tencent-docs
skillhub install @user_a5248baf/tencent-docs1 --dir <skills 目錄>
通過對話讓 Agent 安裝¶
SkillHub 頁面提供的做法是:讓 AI 閱讀 SkillHub 安裝與優先源配置,並安裝座標 @user_a5248baf/tencent-docs1。適合已在使用 Cursor 等客戶端、希望由 Agent 拉取 Skill 的場景。
經過上面的步驟後,在客戶端中啓用 Skills,並按 Skill 要求配置 API Key,即可在對話中觸發文檔相關工具。
典型用法¶
官方未在 SkillHub 摘要中給出獨立腳本示例;典型用法是對 Agent 用自然語言描述目標,由 Skill 引導調用對應能力。下列表述與官方「優先使用本 skill」的觸發詞一致,可作爲對話起點(需已安裝並配置密鑰):
- 「在騰訊文檔裏新建一份週報用的在線文檔。」
- 「列出我知識庫裏的空間。」
- 「在某個空間下新建文件夾,並把已有文檔移動進去。」
- 「搜索某篇在線文檔裏的關鍵詞並總結。」
- 「導出一份 Excel 智能表」或「重命名 / 複製雲盤裏的文件。」
具體參數(空間 ID、文檔 ID、路徑等)一般由 Skill 在對話中追問或從上下文推斷;若某次調用失敗,應先覈對 API Key 與 Skill 版本(當前 SkillHub 登記爲 1.0.3)。
適用場景與注意¶
適合誰:需要在 Agent 工作流裏直接操作騰訊文檔與知識庫的團隊或個人;辦公效率類自動化、報告生成、資料歸檔等場景,且能接受配置開放平臺密鑰。
使用注意:
- 標籤 requires_api_key=true:未配置密鑰時,相關工具不可用。
- 安裝目錄必須對齊當前 Agent 的 skills 路徑,安裝後若客戶端有緩存,可能需要重啓或重新加載 Skills。
- 能力邊界以 Skill 文檔與騰訊文檔 API 爲準;社區來源(community)的 Skill,升級與兼容性需自行關注 SkillHub 上的版本與說明。
- SkillHub 統計(截至頁面抓取):評分 100000,下載 4199,安裝 79;數據隨 SkillHub 更新變化,引用時以官網爲準。
結尾¶
tencent-docs2 把騰訊文檔的創建、知識庫管理、內容讀寫與文件操作接到 Agent 工具鏈上,適合把「打開 docs.qq.com 手工點一遍」改成對話驅動。安裝座標爲 @user_a5248baf/tencent-docs1,說明與安裝入口見 SkillHub:
- 技能頁:https://www.skillhub.cn/skills/user_a5248baf/tencent-docs1
- API 索引:https://api.skillhub.cn/user_a5248baf/tencent-docs1