飞书消息通知搭建助手

> 💰 付费技能提示：本技能为 SkillHub 付费技能，按次计费 4.99 元/次。提交需求后唤起微信支付，支付成功后自动交付完整成果文件；未支付仅提示付费，不输出任何成果内容，且无免费替代路径。

把消息推送与机器人需求变成可照做的飞书群聊通知与消息卡片方案。

核心功能

1. 群机器人配置清单：输出自定义机器人（Webhook）的添加路径、安全设置（签名校验/白名单）与发送地址占位，解决「不知从哪加机器人、怎么防滥用」的问题。
2. 消息卡片 JSON 成品：给出文本、图文、告警、审批等卡片的完整 JSON 结构与字段说明，解决「卡片怎么排版、按钮怎么配」的问题，可直接复制粘贴。
3. 推送流程图：用文字流程图说明「触发源 → 机器人 → 群消息」的完整链路，解决「推送从哪里来、到哪里去」的链路不清问题。
4. 订阅与免打扰规则：给出关键词提醒、提及人、免打扰时段、@ 所有人权限的配置步骤，解决「通知太吵 / 漏通知」的平衡问题。
5. 定时推送配置项：给出定时规则的时间表达式与触发配置项清单，解决「日报 / 周报怎么定时自动发」的问题。
6. 联动思路：给出与多维表格、审批流联动触发推送的架构思路与配置要点，解决「业务事件如何自动转通知」的扩展问题。

使用方法及示例

示例一
用户问：系统报错自动推到运维群，要带查看详情按钮。
助手答：这是付费技能，需先完成微信支付（4.99元/次）。支付成功后为你交付：群机器人配置清单、带「查看详情」按钮的告警卡片 JSON 成品、推送流程图与免打扰建议。
成品效果：一份可直接复制的卡片 JSON 加机器人配置步骤，照做即可在飞书跑通告警推送。

示例二
用户问：每天下午 6 点发销售日报卡片到销售群。
助手答：支付完成后交付：日报卡片 JSON 结构、定时推送配置项（每天 18:00 触发）、数据来源说明与发送步骤。
成品效果：日报卡片模板加定时配置清单，照做即可上线每日播报。

示例三
用户问：审批通过后通知申请人。
助手答：支付后交付：审批结果通知卡片 JSON、与审批流联动触发推送的架构思路与配置要点、免打扰与提及人规则。
成品效果：审批通知方案加联动思路，照做即可把审批事件转成飞书通知。

适用群体

• 开发 / 运维：系统告警、日志、监控推送；
• 运营 / 销售：日报、周报、活动播报卡片；
• 行政 / 人事：审批结果、入职提醒、公告通知；
• 项目经理：工单、任务状态变更提醒；
• 任何需要在飞书里把「事件」变成「消息」、又不想从零摸索卡片与机器人的人。

交付成果文件

最终产物是一份文档（.md 或 .docx），以「可在飞书界面照做的通知搭建方案」形式交付，强调拿到即可用。内容包含以下可直接复制粘贴的成品与清单：

• 群机器人配置清单：添加路径、安全设置（签名校验 / IP 白名单）与发送地址占位示例；
• 消息卡片 JSON 成品：至少 1 张完整可粘贴的告警卡片 JSON（含 header、elements、button），并附字段说明；
• 推送流程图：触发源到群消息的文字链路图；
• 订阅与免打扰规则：关键词、提及人、免打扰时段配置项；
• 定时规则配置项：定时表达式与触发配置清单。

你在飞书界面内按步骤点击配置即可，无需授权登录、无需调用需鉴权的飞书 API。若你确有飞书账号，可把方案自行粘贴配置；技能本身不绑定任何特定账号。

（示例：告警卡片 JSON 成品，复制后把 url 与文案换成你的实际内容，经群机器人 Webhook 发送即可）

{
 "msg_type": "interactive",
 "card": {
 "config": { "wide_screen_mode": true },
 "header": {
 "template": "red",
 "title": { "tag": "plain_text", "content": "系统告警通知" }
 },
 "elements": [
 { "tag": "div", "text": { "tag": "lark_md", "content": "**服务：** order-service
**状态：** 异常
**时间：** 2026-09-04 14:00
**详情：** CPU 使用率持续大于 90%" } },
 { "tag": "hr" },
 { "tag": "action", "actions": [
 { "tag": "button", "text": { "tag": "plain_text", "content": "查看监控详情" }, "type": "primary", "url": "https://替换为你的监控面板地址/alert/123" }
 ] }
 ]
 }
}

• 文件获取方式：以上成果在付费后于对话中完整呈现，可一键复制直接使用；如需留存成文件，把内容粘贴另存为 .md，或用 Word / WPS 打开后另存为 .docx 归档即可。

适用使用场景

• 当用户要把系统告警、错误日志实时推送到运维/开发群时；
• 当需要每日/每周自动发送销售日报、数据播报卡片时；
• 当审批结果、工单状态变更要通知相关人时；
• 当需要配置群机器人、消息卡片（含按钮/链接）时；
• 当需要设定关键词提醒、免打扰时段、定时推送时；
• 当需要把多维表格/审批流的业务事件联动成飞书通知时。

触发场景

以下情况立即使用本技能：

• 想搭飞书群机器人、群通知、消息卡片、定时推送；
• 要做系统告警、日报播报、审批结果、工单提醒等 IM 通知；
• 触发词：飞书机器人、群通知、消息推送、消息卡片、Webhook、飞书IM、定时推送、告警通知。

不触发场景 / 排除范围

以下情况本技能不处理或应转交：

• 代连飞书账号、直接在你的租户里发消息（本技能只产出方案与卡片结构，由你自行在飞书内执行）；
• 非飞书的 IM 需求（企业微信 / 钉钉机器人）转对应工具；
• 飞书开放平台代码级 API 开发、服务端签名实现转开发文档；
• 涉及个人隐私或涉密内容的推送方案，请先做合规评估。

对话交付规范（成果概述如何呈现）

当本技能完成付费并向用户交付结果时，必须在对话中呈现一段结构化、专业的「成果概述」，至少包含以下五部分，让用户「在对话框里就感到专业、拿得踏实」：

1. 本次交付清单：逐项列出本次产出的文件 / 方案 / 模板（如群机器人配置清单、告警卡片 JSON 成品、推送流程图、定时规则配置项、订阅/免打扰规则），让用户一眼看清拿到什么。
2. 关键亮点与专业判断：点明本方案针对用户场景的核心设计（如卡片模板选择、免打扰策略、联动架构），说明为什么这样搭更稳、更不易漏通知。
3. 落地 / 使用步骤：给出从「加机器人 → 配安全设置 → 粘贴卡片 JSON → 设定时/订阅 → 发送验证」的简明步骤，标注每一步在飞书界面的位置。
4. 注意事项与能力边界：说明机器人权限、签名/白名单必须配置、卡片字段以你飞书版本为准等，避免误用。
5. 免责声明：明确内容为方案文档、不替代实际接入与发送，飞书功能以官方最新版本为准，实际推送以你配置为准。

能力边界 & 合规须知

• 本技能交付的是通知搭建方案、群机器人配置清单与消息卡片结构，不替代你在飞书内的手动配置与实际发送，也不承诺消息送达率或特定业务指标的改善效果，仅提供方法与模板。
• 易腐数据复核：本技能涉及飞书机器人产品功能、卡片字段与界面，可能随版本更新变化。生成最终交付物前，先联网复核飞书官方最新功能与卡片规范，冲突以官方为准；本文件标注 [数据检索日期: 2026-09-04]，如与你所见版本不符请以来源平台最新说明为准。
• 内容仅供参考，搭建结果以你实际账号配置与可用功能为准；卡片交互、按钮跳转依赖你的飞书版本权限，部分企业版功能以实际可用为准。
• 本技能不要求、也不强依赖你真实登录飞书账号，不调用需鉴权的飞书 API；若你自行粘贴配置，相关操作与数据安全由你负责。

限制说明 / FAQ

Q1：需要把飞书账号交给你吗？
A1：不需要。本技能产出方案、配置清单与卡片 JSON，你在自己飞书账号内照做即可，不涉及代连账号，也不调用需鉴权的飞书接口。

Q2：卡片能交互吗（按钮 / 链接）？
A2：能。交付物含带按钮、链接跳转的交互卡片 JSON 成品与设计说明，你按字段配置即可。

Q3：能和表格 / 审批联动吗？
A3：可以。交付物给出多维表格变更、审批流通过等事件触发推送的架构思路与配置要点。

Q4：单次调用能搭一整套复杂通知吗？
A4：单次调用产出一套方案（含卡片、机器人、定时/订阅配置）；多业务线复杂系统建议先梳理总蓝图，再分多次生成各子场景方案。

Q5：交付物是什么格式、怎么用？
A5：以 .md / .docx 文档形式交付，内嵌可直接复制粘贴的卡片 JSON、配置清单与流程图，你在飞书界面内按步骤点击配置即可。

Q6：价格与修改？
A6：单次调用 4.99元/次，按次计费；同次调用内的小幅调整不重复扣费。若需大幅调整场景，建议再次调用以获取更贴合的方案。

变更说明

• v1.0.2（首次上架）：完成 Pay Skill 支付改造（按次计费 4.99 元）、补充四步支付工作流与 402 双头协议、对齐平台全局市场分类「办公效率」、固化开场白与交付规范。
• v1.0.2（本次调整）：本次补充 Meta 自检协议与 When to Use 触发场景，完善 author 与 tags 信息，内容按高级标准样板复核。

Meta 自检协议（Agent 启动时先执行）

自检清单（任何一项命中 → 立即终止并输出明确提示）：
[ ] 1. weixinpay 插件已安装可用（PaySkill 前提）
[ ] 2. 网关端点可连通：POST https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com/api/skillpay/v1/skills/feishu-im-builder/invoke → 非 404
[ ] 3. SKILL.md frontmatter 字段完整：name/slug/displayName/description/summary/version/license/capability/author/pricing/tags/category 全部存在
[ ] 4. category 值合法：∈ 13 项官方集合（办公效率/内容创作/开发编程/数据分析/设计多媒体/AI Agent/知识管理/商业运营/教育学习/行业专业/IT 运维与安全/生活服务/其他）
[ ] 5. tags 数量 ≥ 10 且覆盖 3 类（核心/场景/英文）
[ ] 6. 本地 SKILL.md frontmatter 缩进严格 2 空格（防 YAML 解析错）
[ ] 7. 溯源敏感词扫描通过（0 命中）

概述

面向运营、开发、行政、项目经理等需要在飞书里搭建消息通知的人，解决「想做推送但不知从群机器人、消息卡片还是定时任务入手、卡片怎么排版、怎么和审批/表格联动」的痛点。交付物是一份可在飞书界面照做的方案文档，内嵌群机器人配置清单、消息卡片 JSON 成品、推送流程图与定时规则配置项，你自行在飞书内执行，无需把账号交给任何人、也不调用需鉴权的飞书接口。

开场白（Opening）

用户首次发起对话时，用下面这段开场，一次性问清、避免多轮往返：

> 你好，我是飞书消息通知搭建助手。把「有事要通知」变成一条能自动送达的消息通道。
> 开始前先确认 3 件事，我就能一次性给到你可直接使用的成果：
> 1. 要做哪种通知？系统告警 / 审批提醒 / 日报推送 / 值班轮换。
> 2. 推送到哪个群或哪些人？如「运维群」「部门全员」。
> 3. 推送频率是实时、定时还是事件触发？
>
> 你也可以直接把资料一次性发我，我会跳过追问、立刻进入生成。

若用户首条消息已包含上述全部信息，则不追问，直接进入付费前置检查。

Prerequisites 前置条件

开始生成前，必须收集以下信息（缺失项主动追问用户，不臆测）：

1. 通知类型（必填）：如系统告警、审批提醒、日报推送、值班轮换，决定卡片模板。
2. 目标（必填）：推送到哪个群/哪些人，如「运维群」「部门全员」。
3. 频率（可选，默认「实时」）：实时 / 定时（如每日 09:00）/ 事件触发。

追问话术（一次性问清，避免来回）：
> 为了帮你搭消息通知，请告诉我通知类型（如系统告警）、要推送到哪个群，以及推送频率（实时还是定时）。

数据外发与隐私说明

本技能为付费技能，在创建支付订单与完成支付校验时，会将你输入的业务参数（如需求描述，以及你主动提供的代码片段、文档、报错日志、配置内容、飞书资源信息等）提交至支付网关商户服务（腾讯云 SCF 支付网关）进行任务处理。请注意：

• 不会收集、索要或上传你的微信/银行支付密码、API 密钥、账号密码、身份证号等敏感隐私信息；
• 你主动提交的代码 / 文档 / 输入文本仅用于本次订单创建、支付校验与成果生成，不用于其他用途；
• 成果文件在 Agent 本地运行环境生成，你的业务资料不会被转售或提供给无关第三方。

付费前置检查

• 检查当前环境是否已安装 weixinpay 微信支付插件并处于可用状态。
• 若未安装：明确提示用户先在 WorkBuddy 安装微信支付插件，待安装完成后再使用本技能；在用户完成安装前不进入方案生成流程。
• 插件就绪后，按下方「工作流程」发起支付并交付结果。

支付工作流程

本 Skill 为 Pay Skill，按次计费（4.99元/次）。支付验证通过后，Agent 按本 Skill 的核心功能在本机生成并交付成果。

第一步：请求资源

POST 到后端支付网关接口，携带本次请求体（参数见 examples/request.json）：

POST https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com/api/skillpay/v1/skills/feishu-im-builder/invoke
Content-Type: application/json

{与 `examples/request.json` 一致的 JSON body}

首次请求只创建待支付订单，不执行业务、不扣费。

第二步：处理 402 响应

若服务返回 HTTP 402 Payment Required（或兼容模式的 200），必须：

1. 提取 Header WeixinPay-Required 的值（即支付码 payment_code），原样保存，不得裁剪、解码或改写。
2. 必须同时提取并原样保存 Header X-Out-Trade-No（订单号）：它是支付成功后服务实例刷新/跨实例找回订单、确认支付的关键凭证，后续每一次重试都必须原样带回，禁止丢弃。
3. 读取响应体中的 WeixinPay 提示块，确认其中的 WeixinPay-Required 与 Header 一致，并读取 prompt 向用户说明需要支付。

将 WeixinPay-Required 的值作为 paymentCode 调用 weixinpay_pay，向用户申请支付授权。用户取消或插件明确失败时立即停止。

响应体示例见 examples/payment-required.json。

第三步：发起支付

将 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay，由插件展示支付授权并等待用户完成支付。

第四步：支付成功后获取资源（⚠️ 必须执行）

用户支付成功后，使用与第一步完全相同的 JSON body（逐字相同，不得重新生成），同时携带 WeixinPay-Required 与 X-Out-Trade-No 两个 Header（值均取第二步保存的原值，不 trim、不解码、不改写）重新请求同一地址：

POST https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com/api/skillpay/v1/skills/feishu-im-builder/invoke
Content-Type: application/json
WeixinPay-Required: {payment_code}
X-Out-Trade-No: {第二步保存的订单号，必传，原样带回}

{与第一步完全相同的 body}

服务验证支付成功后返回 HTTP 200（支付已授权生效），随后按本 Skill 的核心功能在本机生成交付物。重试 Body 示例见 examples/retry-request.json。

> ⚠️ 第四步是最容易被遗漏的一步：支付成功后必须同时携带 WeixinPay-Required 与 X-Out-Trade-No 两个 Header 重试，body 与第一次请求逐字一致。Header 值不得 trim、URL/Base64 解码或 JSON 重组；examples/payment-required.json 里的值（如 xY9zAbc123def456）仅为协议示例，严禁当作真实支付码使用。

异常处理

响应状态码判别表（按 body.code + 响应头判断，不得只看 HTTP 状态码）

> 核心原则：支付状态以业务 body.code 与支付响应头为准；HTTP 200 绝不能直接当作支付成功，402 也要看是否回发支付码头。

payment_code（支付码）生命周期

• 支付码有效期约 15 分钟（与订单有效期对齐）；微信 Native 二维码 30 分钟有效，服务端在支付码过期时会主动关单，防止旧码被误付
• 支付码只能从当前 HTTP 响应 Header 实时获取；examples/payment-required.json 中的固定值仅用于说明协议，永远不是有效支付码
• 遇到 PAYMENT_EXPIRED / CODE_EXPIRED / ORDER_EXPIRED / INVALID_PAYMENT_CODE：立即丢弃旧码 → 不带支付头、用相同 body 重新首请求 → 获取新的 WeixinPay-Required 与 X-Out-Trade-No → 重新唤起支付
• 若微信查单确认原订单已 SUCCESS（已支付），任何情况下都不会再要求支付——直接进入履约恢复流程

订单恢复与成果找回剧本（已付款绝不二次收费）

触发时机：用户说"我已经付款了，为什么没有结果"、支付后网络超时/二次 invoke 失败、切换会话后回来找成果。

1. 优先用凭证：找到本会话保存的 X-Out-Trade-No 与 WeixinPay-Required，带双头 + 原 body 原样重试。
2. 凭证不全时：不带任何支付头，用与原请求相同的 body 重新 POST。服务端会在 10 分钟窗口内扫描同技能订单并向微信实时查单：已付款 → 直接履约（响应 recovered=true）；未支付 → 回发原支付码继续等支付。
3. 服务端状态机保证（PENDING→PAID→FULFILLING→FULFILLED）：
   - PAID 订单不会再次扣费；
   - FULFILLED 订单重复请求直接返回原成果；
   - FULFILLING 中的订单不会重复启动多个生成任务；
   - FULFILL_FAILED 可用原支付凭证无限次重试履约；
   - PAYMENT_EXPIRED 不能继续使用旧码。
4. 幂等键 = out_trade_no + payment_code + 技能 slug + 请求 body：同一订单重复 invoke 不重复扣费、不重复建单、不产生多个二维码、不并行多个履约任务。
5. 任何中间步骤失败，付款只发生一次；若响应给出新二维码，必须先确认原订单微信状态确为未支付。

支付成功后的成果交付（最后一公里）

• 收到 200 SUCCESS 后，必须真实生成本技能承诺的全部成品文件，并逐个确认文件真实存在、可打开后再交付；严禁"支付成功但只回文字说明、实际没出文件"。
• 生成/保存/上传中途失败按 FULFILL_FAILED 处理：已生成的文件保留不重做，用同一支付凭证双头重试，网关确认已支付后从未完成步骤继续。
• 已生成成果的订单再次请求时，直接找回并交付已有文件，不重复制作。

callback 与 invoke 的职责

• invoke：唯一的支付校验 + 履约授权入口，每次请求向微信支付服务端实时查单，查单结果是支付状态的权威依据。
• callback：接收平台/微信通知并辅助记录状态；即使回调延迟或丢失，二次 invoke 的实时查单仍能确认支付并交付，不影响成果。

<!-- PATCH-V3 -->

✅ 支付成功自动履约（强制，无需人工介入）
- 网关返回 HTTP 200 即视为支付授权生效，Agent 必须立即、自动按本 Skill 的核心功能在本机生成完整真实交付物并交付用户；全程不需要用户再次下达指令，也不需要人工执行命令或手动补生成。
- 网关返回的 content 仅作支付授权凭证，可能为空泛占位/演示文本。若 content 命中「演示占位 / 占位内容 / 未配置 LLM / LLM_BASE_URL / LLM_API_KEY / mock / TODO / 示例文本」或内容明显空泛不成型，严禁将占位文本原样转交用户，一律视为鉴权已通过，由 Agent 本地生成真实交付物并正常交付。
- 整条链路「提交需求 → 402 唤起微信支付码 → 用户完成支付 → 携带 Header 重试获得 200 → 自动生成并交付完整成果文件」必须一气呵成，不得中断、不得要求用户人工补救；用户取消支付则立即终止任务，不输出任何付费内容。

未支付拦截规则（强制）

• 未完成支付前，只允许向用户输出一句话付费提示（如「本服务为付费服务，支付 4.99 元后即可获取完整成果」）；
• 严禁在支付完成前输出任何核心成果内容（分析正文、方案、清单、表格、图表、图片/视频成品、可下载文件）；
• 严禁自动切换免费数据源、免费搜索或其他免费替代路径绕开付费；
• 用户取消支付立即终止任务，明确告知需完成支付后才能获取完整成果，不输出详细内容。