前言¶
在 Cursor、Claude Code 等環境裏做辦公自動化時,常見做法是各自對接企業微信開放 API,或讓用戶手動複製 doc.weixin.qq.com 鏈接再粘貼到對話裏。消息、日程、在線文檔、智能表格、會議和待辦往往分散在不同接口與權限裏,Agent 很難在一次對話裏連貫完成「找人 → 發消息 → 改文檔 → 約會議」這類鏈路。
下面介紹 SkillHub 上的 企業微信套件(@tencent-adm/wecom-unified):由企業微信團隊發佈的企業微信 CLI 全能套件,把通訊錄、消息、文檔、日程、會議、待辦六個業務域收攏到同一 Skill,供 Agent 按場景觸發並執行。
這是什麼¶
企業微信套件 是面向 Agent 的企業微信 CLI 能力包,座標 @tencent-adm/wecom-unified,當前版本 1.0.7,分類爲 office-efficiency,來源標註爲 enterprise。SkillHub 頁面顯示標籤 requires_api_key=false,即安裝說明中未要求單獨配置 API Key(具體鑑權以 Skill 內文檔與企業微信側環境爲準)。
維護方爲 企業微信團隊。它要解決的問題是:讓 Agent 在用戶提到或隱含企業微信辦公場景時,能統一調用套件能力,而不必在對話裏反覆說明「請用企業微信 API」。
核心功能¶
以下能力均來自 SkillHub 官方簡介,按六個業務域歸納。
通訊錄¶
- 支持按 姓名 或 別名 查找聯繫人。
消息¶
- 支持收發消息,媒體類型包括:文本、圖片、文件、語音、視頻。
文檔與表格¶
- 文檔:讀取、創建、編輯文檔;可由
https://doc.weixin.qq.com/XXXX形式鏈接觸發相關操作。 - 在線表格:讀取表格內容。
- 智能表格:讀寫子表、字段、記錄。
- 智能文檔:創建並導出智能文檔。
日程¶
- 創建、修改、取消日程。
- 查詢閒忙狀態。
會議¶
- 預約與管理會議。
待辦¶
- 創建、跟蹤、分派待辦任務。
觸發範圍(Agent 側)¶
即使用戶未明確說「企業微信」,只要對話涉及下列場景,官方說明也建議觸發本 Skill:
doc.weixin.qq.com域名或對應 URL;- 消息、日程、待辦、文檔、表格、會議;
- 找人(通訊錄查詢)。
安裝與啓用¶
SkillHub 提供兩種常見安裝方式:向 Agent 發送安裝提示詞,或使用 skillhub CLI。
方式一:提示詞安裝¶
將下面說明發給當前 Agent,讓其按 SkillHub 安裝文檔執行:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@tencent-adm/wecom-unified`。
方式二:skillhub CLI¶
若尚未安裝 CLI,可先檢查版本:
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 文檔執行完整安裝(示例來自 https://skillhub.cn/install/skillhub.md):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 Skill 時 必須 使用 --dir 指向當前 Agent 的 skills 目錄,否則默認裝到 ./skills/ 可能無法被識別。示例:
skillhub install @tencent-adm/wecom-unified --dir <skills 目錄>
各客戶端常用 skills 路徑(摘自 SkillHub 安裝文檔):
| 客戶端 | 路徑 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝後按所用 Agent 的要求重啓或刷新 Skill 列表,使 @tencent-adm/wecom-unified 生效。
典型用法¶
官方 SkillHub 頁面未給出逐條 CLI 子命令示例;實際調用方式以安裝後 Skill 目錄內的 SKILL.md 及企業微信 CLI 說明爲準。從已公開描述可復現的 對話層用法 如下。
- 粘貼文檔鏈接:用戶發送
https://doc.weixin.qq.com/...,Agent 應識別並啓用本套件,執行讀/寫/編輯文檔等操作。 - 自然語言辦公任務:例如「按別名找張三併發一條文本消息」「查明天下午閒忙併創建日程」「讀取某在線表格」「在智能表格裏新增一條記錄」「預約會議」「創建待辦並分派給同事」——均屬於簡介中列出的能力範圍。
- 跨域串聯:同一對話內先查聯繫人再發消息、或先讀表格再寫文檔,依賴 Agent 根據 Skill 內指引組合 CLI,而非用戶自行拼 HTTP 請求。
若需搜索或確認包名,可在本機使用:
skillhub search wecom-unified
適用場景與注意¶
適合誰
- 已在企業微信內使用文檔、表格、日程、會議、待辦,希望 Agent 直接操作而非只給操作步驟的用戶。
- 需要在對話裏處理
doc.weixin.qq.com鏈接的開發者或知識工作者。 - 希望用 SkillHub 統一安裝、由企業微信團隊維護的一體化套件,而不是零散自建 Skill 的團隊。
注意
- 能力邊界以 Skill 1.0.7 官方簡介爲準;未在簡介中出現的接口或產品形態不要默認支持。
requires_api_key=false僅表示 SkillHub 元數據未標記必填 API Key;企業微信 CLI 仍可能依賴本機登錄、企業配置或 Skill 內其它憑據,以安裝後的 Skill 文檔爲準。- SkillHub 統計(截至頁面展示):評分 100000,下載 35205,安裝 51;選用時可結合團隊合規要求與企業微信使用規範。
- 安裝路徑錯誤會導致 Agent 無法加載 Skill,務必使用
--dir指向當前環境的 skills 目錄。
結尾¶
企業微信套件把通訊錄、消息、文檔、日程、會議、待辦六類能力打包爲 @tencent-adm/wecom-unified,並明確 doc.weixin.qq.com 及多種辦公關鍵詞的觸發範圍,適合作爲 Agent 側的企業微信 CLI 入口。官方 Skill 地址:https://api.skillhub.cn/tencent-adm/wecom-unified;SkillHub 詳情頁:https://www.skillhub.cn/skills/tencent-adm/wecom-unified。