前言¶
企业微信 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
