飞书画图 Skill

design-lark-chart 是一个面向 Agent 的飞书画板生成技能。它把自然语言说明、参考截图、或飞书文档中的业务内容，转成可继续编辑的飞书画板图表，而不是只能观看的静态图片。

给它一个业务背景、期望图表类型和输出位置，Agent 会读取材料、规划图表结构、生成画板内容、写入飞书文档，并导出真实飞书画板图用于验收。

一句话安装

把下面这句话发给你的 Agent 即可：

请从 GitHub 仓库 https://github.com/fuxiaoai/lark-chart-skill 安装路径为 skills/design-lark-chart 的技能。

它解决什么问题

很多文档配图工具只能生成一张图片。这个 Skill 的目标更明确：把图真正落到飞书画板中，让用户可以继续改节点、改文字、调连线、改颜色，并保留飞书文档里的协作体验。

适合这些场景：

• 给已有飞书文档补架构图、流程图、泳道图、时序图、矩阵图等专业配图。
• 新建一份说明文档，并自动插入一个或多个飞书画板。
• 把复杂业务材料转成可演示、可评审、可二次编辑的结构化图表。
• 在固定图表类型覆盖不到时，进入自由画图模式，生成产品原型、桑基图、地图、技术原理图、插画风格画板等。

为什么它不是普通截图生成器

下面所有示例图都来自飞书文档中的真实 `` 画板块，README 中展示的是通过飞书画板导出的预览图。源对象仍然是飞书画板：打开原始飞书文档后，可以进入画板继续编辑里面的节点、形状、文字和连线。

[!IMPORTANT] 想验证它不是静态截图？ 打开原始飞书文档后，可以直接进入对应飞书画板，继续编辑 节点、文字、形状和连线。 验证入口： 查看原始飞书画板文档

自由画图 Showcase

自由画图模式适用于固定模板无法覆盖的表达。它会先理解意图，再用 SVG/OpenAPI 或画板 DSL 路径生成可编辑画板。

17 类专业图表示例

以下示例以“评测系统”为业务背景，覆盖常见的技术文档、产品方案和运营分析图表类型。每张图都来自飞书画板导出，不是手工贴到 README 的静态截图。

支持的图表类型

固定图表类型包括：业务架构图、系统架构图、流程图、泳道图、复杂业务泳道图、时序图、组织架构图、状态机图、ER 图、思维导图、漏斗图、甘特图、里程碑图、矩阵象限图、链路架构图、飞书画板风格架构图、手绘风格架构图。

自由画图模式覆盖：产品原型、页面截图还原、桑基图、路线图、地图、游戏画面、技术原理图、插画风格画板，以及其他无法用固定图表类型表达的视觉需求。

工作方式

Skill 内部按一条闭环管道工作：

Normalize -> Select -> Plan -> Layout -> Render -> StaticCheck -> VQA -> Deliver

它不会把某几张图硬编码成模板，而是从用户输入中抽取业务结构，再结合 assets/style-tokens/ 中的飞书画板风格指纹进行设计。交付前会按路由执行质量门：

• DSL 路径：whiteboard-cli --check 检查布局、文字溢出和节点问题。
• SVG 路径：whiteboard-cli -f svg --check、SVG 质量 lint、OpenAPI 转换。
• Mermaid / PlantUML 路径：写入飞书后回读源码，并导出真实飞书画板图。
• 所有路径：最终都要基于飞书端真实导出图做视觉验收。

仓库结构

.
├── README.md
├── assets/showcase/                 # README 展示用的飞书画板导出图
└── skills/design-lark-chart/
    ├── SKILL.md                     # Agent 读取的技能入口
    ├── assets/                      # 飞书画板参考图、raw 结构、style tokens
    ├── references/                  # 管道、图表分类、质量门、自由画图说明
    └── scripts/                     # 本地校验、预览、SVG 自由模式门禁脚本

使用示例

安装后可以直接对 Agent 说：

读取这个飞书文档，给“系统设计”章节补一张飞书画板风格的系统架构图，并写回原文档。

新建一份飞书文档，主题是“评测平台方案说明”，帮我自动配一张业务架构图和一张端到端链路架构图。

参考这张产品截图，把它画成可编辑的飞书画板产品原型图。

本地依赖

运行这个 Skill 的 Agent 环境需要能够调用 lark-cli 和 whiteboard-cli。首次写入用户飞书文档时，按 Agent 提示完成飞书授权即可。

License

Apache License 2.0. See LICENSE.