webhook-push

统一发送企业微信、钉钉、飞书Webhook通知的Skill。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:webhook-push。
它的用途是:统一发送企业微信、钉钉、飞书Webhook通知的Skill。
完整的 Skill 内容见:https://321skill.com/skills/webhook-push/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我用Webhook Push Skill给钉钉群发一个Markdown格式的服务器CPU告警通知,内容包含当前使用率和服务器IP。”,它会引导你构建一个`UnifiedMessage`对象,指定消息类型为markdown,并填充告警内容,然后调用发送方法将消息推送到你配置的钉钉Webhook地址。

介绍

Webhook Push Skill 解决了开发者需要为不同企业通讯平台(如企业微信、钉钉、飞书)分别编写通知代码的痛点。它提供了一个统一的接口,开发者只需使用一套消息模型,即可将通知发送到任意支持的平台,Skill内部会自动处理格式转换和平台差异。

使用方式非常简单:通过 pip 安装后,导入 MessageSenderUnifiedMessage 类,构建统一格式的消息体,然后调用 send 方法并指定目标平台和Webhook地址即可发送。支持文本、Markdown、卡片、图片、文件等多种富文本消息类型。

这个Skill非常适合需要将系统告警、任务通知、数据报告等消息集成到国内主流企业IM中的开发者、运维和产品经理。无论是监控系统状态、同步项目进展,还是推送营销数据,都可以通过它快速实现。

使用建议:建议在发送前根据目标平台的官方文档确认Webhook URL和Token的正确性。虽然Skill内置了优雅降级和重试机制,但在生产环境中仍需关注各平台的API调用频率限制,并做好错误日志记录。对于不支持的高级特性,消息会被自动转换为基础格式。

核心特点

核心区别在于提供了真正统一、平台无关的消息模型,并内置了三大平台(企业微信、钉钉、飞书)的格式转换与优雅降级逻辑,无需开发者手动适配。同时,它原生支持丰富的消息类型和内置重试、限流处理。

注意事项

不适合需要调用平台更复杂API(如发送应用内消息、管理群组、读取消息)的场景,它仅专注于Webhook推送。

常见问题

如何获取钉钉/企业微信/飞书的Webhook地址?

需要在各自平台的机器人或应用管理后台创建Webhook机器人,获取对应的URL和access_token。

发送失败会自动重试吗?

是的,Skill内置了指数退避的重试机制,并会处理平台方的速率限制。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/webhook-push/raw/index.md 读取 webhook-push 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。