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