前言¶
企業微信 CLI（wecom-cli）適合在終端裏發消息、對接機器人、做自動化。實際落地時，常見問題不是「有沒有文檔」，而是環境沒對齊：Node.js 版本不對、全局命令裝完卻找不到、Skills 技能包沒裝上、初始化步驟漏了一步，報錯信息又不好對號入座。
自己對着 README 逐步敲命令可以完成，但每一步都要判斷當前機器狀態。下面介紹 SkillHub 上的社區 Skill「企微CLI一鍵安裝助手」，把檢測、安裝、驗證和排錯收斂成 Agent 可執行的一輪對話流程。
這是什麼¶
「企微CLI一鍵安裝助手」是 SkillHub 社區 Skill，座標 @user_af28adda/wecom-cli-installer，當前版本 1.0.0，分類爲 dev-programming，發佈者爲 user_af28adda，來源標註爲 community。頁面標籤 requires_api_key=false，表示安裝本 Skill 本身不需要額外 API Key。
它面向「要在本機裝好並可用 wecom-cli」的開發者：當對話裏出現安裝、初始化、配置機器人或常見失敗場景時，由 Agent 按 Skill 指引自動推進，而不是讓人從零拼湊命令。
官方頁面：
- https://www.skillhub.cn/skills/user_af28adda/wecom-cli-installer
- https://api.skillhub.cn/user_af28adda/wecom-cli-installer
核心功能¶
以下能力均來自 Skill 官方簡介，未在資料中出現的具體命令或配置項不展開。
-
觸發識別：用戶提到例如「安裝企業微信 CLI」「安裝 wecom-cli」「企微 CLI 怎麼安裝」「一鍵安裝企微」「配置企業微信機器人」「初始化企微 CLI」「wecom-cli 安裝」「企業微信命令行工具安裝」，或「wecom-cli 裝了但沒反應」「wecom-cli 報錯」「wecom-cli 連接失敗」「wecom-cli 找不到命令」「wecom-cli 失敗」等表述時，應啓用本 Skill。
-
環境檢測：自動做 Node.js 檢測，避免在缺少或版本不合適的環境下硬裝 CLI。
-
安裝鏈路：覆蓋 CLI 安裝、Skills 技能包安裝、驗證，以及 初始化引導 全流程。
-
故障排查：對安裝後無響應、命令找不到、連接失敗等場景提供 故障排查指引，與上述觸發語對應。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 SkillHub 安裝到當前 Agent 的 skills 目錄後纔會被識別。
方式一：用自然語言讓 AI 安裝（官方頁面推薦）¶
把下面提示詞發給支持 Skill 的 AI 客戶端，讓其按 SkillHub 安裝文檔執行：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_af28adda/wecom-cli-installer`。
方式二：本機已有 skillhub CLI¶
先確認 CLI 是否可用：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔執行完整安裝（文檔中的推薦方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 Skill 時 必須 使用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能讀不到。各客戶端路徑不同，文檔中列出的示例如下：
| 客戶端 | skills 目錄（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝命令形式（將 <skills 目錄> 換成你當前環境的路徑）：
skillhub install @user_af28adda/wecom-cli-installer --dir <skills 目錄>
也可先搜索再安裝：
skillhub search wecom-cli-installer
skillhub install @user_af28adda/wecom-cli-installer --dir <skills 目錄>
說明：Cursor、Claude Code、Codex 等僅在 skills 根目錄上存在差異；SkillHub 安裝文檔未單獨寫某一客戶端的額外配置項時，按上表選目錄即可。安裝或更新 Skill 後，若客戶端要求重啓或重新加載 skills，按該客戶端說明操作。
典型用法¶
啓用本 Skill 後，用自然語言描述目標即可，無需先背 wecom-cli 的安裝命令。官方簡介中的典型入口包括：
- 首次安裝：「幫我安裝 wecom-cli」「企微 CLI 怎麼安裝」
- 機器人與初始化：「配置企業微信機器人」「初始化企微 CLI」
- 排錯：「wecom-cli 找不到命令」「wecom-cli 連接失敗」「wecom-cli 裝了但沒反應」
經過上面的步驟，Agent 應依次完成 Node.js 檢測、CLI 與相關 Skills 包安裝、驗證，並在需要時給出初始化與排錯指引。具體執行的 shell 命令以 Skill 內 SKILL.md 與當時終端輸出爲準，本文不臆造 npm 包名或配置文件字段。
適用場景與注意¶
適合誰
- 需要在本地或 CI 相關環境裏快速拉起 wecom-cli，並希望 Agent 代勞檢測與安裝步驟的開發者。
- 已經嘗試過安裝但卡在「命令不存在」「連接失敗」等錯誤，需要結構化排查路徑的人。
限制與注意
- 本 Skill 描述的是 安裝與初始化引導，不包含企業微信後臺審批、CorpID/Secret 等企業側審批流程的替代；憑證仍須按企業微信官方要求自行申請與保管。
- 社區來源（community），行爲以 Skill 包內文檔爲準；升級前可在 SkillHub 頁面確認版本仍爲 1.0.0 或查看是否有新版本。
- 沙箱或限網環境下執行
curl安裝 skillhub CLI 時，需允許對應網絡權限，否則 CLI 本身可能裝不上，進而無法通過skillhub install拉取本 Skill。
SkillHub 頁面統計（以抓取資料爲準）：評分 100000，下載 6703，安裝 439。
結尾¶
「企微CLI一鍵安裝助手」把 wecom-cli 從環境檢查到驗證、初始化、常見失敗排查串成一條 Agent 可執行的鏈路，適合用對話代替手工翻文檔裝 CLI 的場景。安裝與詳情見 SkillHub：
https://www.skillhub.cn/skills/user_af28adda/wecom-cli-installer
