前言¶
团队里常见三类协作 IM:企业微信、钉钉、飞书。要把监控告警、日报汇总、审批提醒或业务数据推到群里,往往要分别查各平台的机器人文档,Webhook 地址、签名校验和消息体字段也不一致,示例代码容易抄错平台。
下面介绍 SkillHub 上的社区 Skill「企微/钉钉/飞书机器人开发」,在对话里把选型、接入和消息格式交给 Agent 按统一指引推进,减少来回翻官方文档的时间。
这是什么¶
「企微/钉钉/飞书机器人开发」是 SkillHub 坐标 @user_36c7efa2/wxwork-bot-dev 下的 Agent Skill,版本 1.0.0,分类为 dev-programming,来源为 community,由发布者 user_36c7efa2 维护。
官方简介:帮开发者用企业微信、钉钉、飞书机器人做告警、日报、审批提醒、数据推送。Skill 采用通用的 SKILL.md 格式,安装后由 Agent 在相关对话中读取技能说明并给出可落地的步骤与示例方向。
SkillHub 页面:https://www.skillhub.cn/skills/user_36c7efa2/wxwork-bot-dev
API 入口:https://api.skillhub.cn/user_36c7efa2/wxwork-bot-dev
核心功能¶
依据 SkillHub 已公开信息,可核实的能力边界如下:
- 多平台机器人场景:覆盖企业微信、钉钉、飞书三类常见办公 IM 的机器人接入与消息推送需求。
- 典型业务用途:告警通知、日报推送、审批提醒、数据推送(与官方简介一致)。
- 技能元数据:标签
requires_api_key=false,表示在 SkillHub 侧安装该 Skill 本身不强制配置 API Key;实际向各平台发消息仍须在对应管理后台创建机器人并保管 Webhook、密钥等平台侧凭证。 - 对话触发:当你在对话中提到企业微信机器人、钉钉机器人、飞书机器人、Webhook、消息推送等意图时,适合启用本 Skill,让 Agent 按技能文档组织回答。
公开页面未单独列出模块清单;具体步骤、字段与限制以安装后包内的 SKILL.md 为准。
安装与启用¶
方式一:用自然语言让 AI 安装¶
SkillHub 官方给出的安装提示词如下。将整段发给当前使用的 AI 客户端即可:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_36c7efa2/wxwork-bot-dev`。
方式二: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
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,Agent 可能无法识别。常用路径示例:
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形式(将 <skills 目录> 换成上表对应路径):
skillhub install @user_36c7efa2/wxwork-bot-dev --dir <skills 目录>
也可先搜索再安装:
skillhub search wxwork-bot-dev
skillhub install @user_36c7efa2/wxwork-bot-dev --dir <skills 目录>
经上面的步骤装好后,重启或刷新 Agent 的 skills 加载方式(以你所用客户端文档为准),再在对话中提出机器人接入或推送需求即可。
典型用法¶
公开资料未附带独立的可复制代码仓库链接;可复现的「用法」首先是完成安装,再在对话中描述目标平台与场景。例如:
- 说明要用企业微信、钉钉还是飞书,以及要做告警、日报、审批提醒还是数据推送。
- 说明是否已有群机器人 Webhook,或需要从管理后台新建机器人。
- 让 Agent 按本 Skill 的 SKILL.md 给出 Webhook 配置、签名校验(若平台要求)、消息体格式与安全限制等方面的步骤与示例。
安装提示词本身即官方推荐的第一条操作,可直接作为会话起点。
适用场景与注意¶
适合谁
- 需要在企业微信、钉钉或飞书中做机器人消息推送的后端、运维或全栈开发者。
- 希望在一个对话里对比或切换平台接入方式,而不是每次从零翻三家文档的人。
使用注意
- 社区来源(
community)技能,内容与各平台官方 API 变更的同步节奏取决于维护者;上线前请在目标环境自测。 - SkillHub 统计(以抓取时页面为准):评分 100000,下载 1709;安装数在页面上为 0,仅作参考,不代表技能不可用。
- 机器人 Webhook URL、签名密钥等属于敏感信息,不要写进公开仓库或日志;生产环境注意各平台频率与安全策略。
- 本 Skill 解决的是「如何在 Agent 协作下开发/配置机器人」;不能替代各 IM 平台的管理员权限与合规审批。
结尾¶
「企微/钉钉/飞书机器人开发」把三类办公 IM 机器人常见的推送场景收拢到一条 Skill 路径里,适合在 Cursor 等支持 skills 的客户端中,通过安装 @user_36c7efa2/wxwork-bot-dev 后按需提问。详情与版本信息见 SkillHub:https://www.skillhub.cn/skills/user_36c7efa2/wxwork-bot-dev