可视化报告生成
把飞书文档、电子表格、wiki 和 PDF 附件里的结构化数据,转成信息密度高的 HTML 速览图,并完成截图、上传飞书、返回链接的完整闭环。适用于周会进展、健康度巡检、业务宣贯和 OKR 看板。
版本未标注 · MEXC Design · 更新于 2026/07/22
快速开始
1. 下载 ZIP,不需要解压。
2. 打开 Claude 桌面端 → Customize → Skills → + → Upload a skill,选中这个 ZIP。
3. 在列表里打开这个 Skill 的开关,之后正常描述需求即可,Claude 会自动调用。
先在 Settings → Capabilities 里开启「Code execution and file creation」。
工作流程
1
提供需求
2
理解与规划
3
生成创意稿
4
优化定稿
5
输出交付
规则与约束
页面基础色只用 #F3F4F7、#0057FF、#000000、#FFFFFF,状态语义色仅用于状态表达。
统一使用 Noto Sans SC,禁止用描边或阴影模拟加粗。
所有 KPI 必须以「目标 vs 当前 vs 环比」三段式展示。
横屏优先,高度控制在 1300px 以内,不做长图。
完整 SKILL.md
把飞书文档、电子表格、wiki 和 PDF 附件里的结构化数据,转成信息密度高、视觉清晰的 HTML 速览图,并完成「截图 → 上传飞书 → 返回链接」的完整闭环。支持多数据源融合、环比对比、OKR 目标与进展可视化。
前置条件
· lark-cli 已安装并登录
· Python 环境已安装 playwright 与 chromium
· PDF 数据源还需要 pymupdf
· 准备好企业 Logo 素材
必要输入
· 数据源:飞书文档、电子表格、wiki 或 PDF 附件的链接或 token
· 报告主题与时间范围
· 需要突出的核心指标、目标值与对比基线
· 场景类型:周会进展、健康度巡检、业务宣贯或 OKR 看板
· 风险项与行动项
· 输出尺寸,默认 1800×1100 横向双栏
执行流程
1. 数据采集:文档用 fetch 并指定 v2 接口,表格用 sheets 读取,PDF 先下载再用 pymupdf 提取文本。
2. 多源融合:多份材料对比时分别读取后合并字段,重点提取当前值、上期基线、目标值、达成率、环比变化、风险与行动项。
3. HTML 生成:调用模板注入数据,先统一到企业视觉规范再使用。
4. 截图:用 Playwright 按目标宽度打开,等待渲染完成,取实际高度后整页截图。
5. 上传飞书:创建文档并插入图片,返回文档链接和本地 HTML、PNG 路径。
输出契约
飞书文档链接 —— 已嵌入图片的文档地址。
本地 HTML —— 可再编辑的源文件。
本地 PNG —— 截图成品。
数据来源栏 —— 页面底部逐项列出数据出处。
设计规范
· 页面背景 #F3F4F7,主题色 #0057FF,正文 #000000,内容区块白底圆角 12px。
· 顶部标题栏蓝底白字,左上角放企业 Logo,宽度不超过 180px、高度不超过 48px。
· 状态语义色:红 #E53935 高风险、黄 #F59E0B 中风险、蓝 #0057FF 正常进行、绿 #16A34A 优于计划。
· 字体统一 Noto Sans SC:主标题 60px/900、项目标题 26px/800 蓝色、正文 16px/400 黑色。
· 8pt 网格,同一行卡片等宽等高,左右边缘严格对齐。
· 结构顺序:标题栏 → KPI 概览条 → 双栏主体 → 风险与行动 → 数据来源栏。
执行规则
· 文档读取必须指定 v2 接口,v1 已弃用。
· 插入图片必须用相对路径,绝对路径会报 unsafe file path。
· 文档里的嵌入式表格要单独读取,核心指标常在其中。
· 截图前等待页面完全渲染,再取实际高度整页截图。
· 不使用深色主题、玻璃拟态、渐变、阴影和额外装饰色。
· 不用描边或重复绘制模拟加粗,文字层级靠字号、字重和留白区分。
· 长文本必须换行,任何文字不得溢出白色区块;拥挤时优先增加画布高度。
调用模板
使用可视化报告生成 Skill,基于以下飞书文档生成本周进展速览图。读取文档和其中嵌入的表格,提取核心指标的目标值、当前值和环比,输出 HTML、截图并上传飞书返回链接。
示例
输入:
基于某篇飞书文档生成中台技术本周进展速览。
预期行为:
1. 读取文档,并提取其中嵌入的表格 token 读取 OKR 数据。
2. 套用周报模板生成 HTML,写入本地。
3. 按 1800px 宽整页截图。
4. 创建飞书文档、用相对路径插入图片,返回链接与本地路径。