前言¶
做企業微信（WeCom）對接時，文檔分散在開放平臺多個章節裏：應用憑證、回調校驗、消息類型、通訊錄與審批接口等。把問題丟給通用大模型，容易混用舊版接口、漏掉簽名校驗或 corpId/agentId 的約束。下面介紹 OpenWecom Skill：它在 SkillHub 上以結構化 Skill 形式發佈，把企業微信開發相關的知識體系交給 Agent 讀取，減少「憑記憶瞎編接口」的情況。
這是什麼¶
OpenWecom Skill（座標 @user_c97d0d7a/openwecomskill）是一套面向 AI 大模型的企業微信開發結構化知識體系。官方簡介表述爲：讓你的 AI 大模型成爲企業微信開發專家。
- 維護方：SkillHub 社區發佈者
user_c97d0d7a，來源標註爲 community。 - 分類：
dev-programming。 - 當前版本：1.0.0。
- 標籤：
requires_api_key=false，安裝該 Skill 本身不要求額外配置 API Key（企業微信應用側憑證仍按你自己的項目需要配置）。
SkillHub 頁面：https://www.skillhub.cn/skills/user_c97d0d7a/openwecomskill
資源入口：https://api.skillhub.cn/user_c97d0d7a/openwecomskill
核心功能¶
已公開資料中，該 Skill 的能力邊界可以概括爲一點：將企業微信開發知識以 Skill（SKILL.md 體系）組織，供 Agent 在編碼與排錯時引用，而不是單獨提供一個運行時服務或 SDK。
因此你在對話裏可以依賴它完成的事，主要是知識側的支持，例如：
- 按企業微信開放平臺概念解釋應用、回調、消息與通訊錄等模塊；
- 在寫接入代碼、對照文檔、梳理參數與流程時，讓模型按 Skill 內的結構化說明作答。
頁面未單獨羅列子模塊清單或文件樹；具體覆蓋的接口與章節以安裝後 Skill 包內文檔爲準，本文不展開未覈實的能力點。
安裝與啓用¶
SkillHub 推薦兩種方式：用 CLI 安裝，或把安裝提示詞發給當前使用的 AI，讓其按官方安裝文檔操作。
1、用 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
安裝 OpenWecom Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄；默認裝到 ./skills/ 時，部分客戶端不會自動加載。
skillhub install @user_c97d0d7a/openwecomskill --dir <你的 skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後若客戶端需要重啓或重新索引 skills，按你所用產品的說明處理。
2、通過提示詞讓 AI 安裝¶
SkillHub 頁面提供的提示詞大意如下：請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_c97d0d7a/openwecomskill。
把上述要求發給 Cursor、Claude Code 等支持 Agent Skills 的環境即可；Agent 會按 skillhub.md 中的檢查 CLI、選擇 --dir 等步驟執行。
典型用法¶
安裝完成並確認 Skill 已被當前 Agent 加載後，用自然語言描述你的企業微信開發任務即可，例如：
- 說明場景（自建應用、回調 URL、接收消息、調用通訊錄接口等）；
- 貼出你已有的配置片段或報錯（注意不要泄露生產 secret）；
- 讓模型按企業微信開放平臺約束給出步驟、參數說明或示例代碼骨架。
這是 Skill 類能力的通用用法：模型在回答時讀取 Skill 內結構化知識，而不是僅依賴預訓練裏的零散記憶。
適用場景與注意¶
適合誰
- 正在做企業微信應用、回調、消息或開放 API 接入的開發者；
- 希望在 Cursor、Claude Code、Codex 等環境裏，讓 Agent 更穩定地圍繞 WeCom 文檔語境作答的團隊。
限制與注意
- 社區 Skill，質量與更新節奏取決於發佈者；接入生產前仍應以企業微信開發者文檔爲準做覈對。
- Skill 提供的是知識與指導，不能替代你在企業微信管理後臺創建應用、配置可信域名與回調等操作。
- SkillHub 統計（截至頁面抓取）：評分 100000，下載 1468，安裝 78；數字會隨時間變化，以 SkillHub 頁面爲準。
結尾¶
OpenWecom Skill 把企業微信開發知識打包成 Agent 可讀的 Skill，適合在日常編碼與排錯裏減少接口與流程上的「幻覺」。需要安裝或查看說明時，可打開 SkillHub 頁面：https://www.skillhub.cn/skills/user_c97d0d7a/openwecomskill ，資源入口：https://api.skillhub.cn/user_c97d0d7a/openwecomskill 。
