飞书卡片消息设计规范

要解决什么问题

飞书机器人与自动化流程里，互动卡片是承载告警、审批、日报的主渠道。卡片本质是结构化 JSON（常见为 msg_type: interactive 加 card 体），字段名、嵌套层级和组件类型都有平台约束。模型若按「大概像卡片」去写，很容易出现组件不识别、布局塌陷或端上渲染异常，排查成本往往落在业务开发身上。

技能如何帮助你

本技能把 飞书卡片消息设计规范 收敛成可被大模型遵循的说明，侧重：

• 信息架构：标题区、正文区、操作区如何分工，何时用 div/markdown/note 等块级元素
• 交互组件：按钮、下拉、日期等组件的适用场景与文案长度习惯
• 视觉与可读性：强调层级、避免一屏堆过多主按钮、告警类信息的对比度与语气
• 可维护性：模板化字段命名、可复用的卡片骨架，方便后续改文案而不动结构

在对话中引用该技能后，模型会按规范组织卡片草案，你再对照飞书开放平台文档做最终校验与发布。

适用边界

这是 设计向 的规范技能，不替代 Open API 鉴权、发消息接口或事件订阅的实现细节。不同客户端版本对个别组件的支持可能有差异，上线前仍建议在目标环境做一次真机/真群预览。若你只需要纯文本或简单富文本，不必强行套卡片结构。