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 安装后,导入 MessageSender 和 UnifiedMessage 类,构建统一格式的消息体,然后调用 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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/webhook-push/raw/index.md(查看排版版本)