技能介绍

它解决什么问题

飞书卡片的 Schema 很严格：markdown 表格不渲染，# / ## heading 会被原样显示，note 标签在 2.0 下可能 400，日期用 date data_type 也容易踩坑。手工拼 JSON 时，展示层会占掉大量时间，内容逻辑和卡片观感混在一起。

它如何工作

这个技能定位是模板引擎，不是规则手册。输入数据后，按 URL 特征识别数据源：/base/...?table=... 走多维表格，/docx/... 走文档，/wiki/... 走知识库节点，口头描述则直接结构化。字段名不硬编码，会按名称、负责人、状态、分类、优先级、日期、描述等语义匹配。

它提供三个脚本：build_card.py 从模板构建卡片；validate_card.py 返回 valid: true/false，覆盖关键约束；push_card.py 输出标准 message 工具调用 JSON，直接推到目标 chat_id。模板只有四类：dashboard、comparison、text_analysis、notice。有明确行列且记录较多用看板，多组对照用对比，长文本用文本分析，纯通知用简讯。

适用边界与注意点

适合把飞书多维表格、文档或知识库数据快速变成可推送的卡片，不负责内容意图判断。展示组件要选对：结构化明细优先 table，状态列用 options 带颜色；column_set 里只放纯文本。颜色语义可按完成/正常 green、进行中 blue、待处理 grey、等待/暂停 orange、阻塞/失败 red 对齐。

page_size 有效范围是 1～10；2.0 下 header 样式不单独存在，需通过 header.title 自定义。不要用 template_id + 变量，模板没有变量定义会导致内容被忽略。推送成功后只回 NO_REPLY；数据为空时卡片只放“📊 暂无数据”并 NO_REPLY。另需注意 2.0 卡片仅支持飞书客户端 V7.20 及以上，低版本会提示升级。