返回项目

OPEN SOURCE REPOSITORY

相关仓库

feishu-whiteboard-workbench-skills
SKILL · 按需调用不是 Agent

基于飞书文档的白板绘图 Skill

Feishu Whiteboard Workbench

把自然语言、产品方案或 SOW 转成可预览、可检查、可粘贴为飞书原生对象的白板图。

角色
Skill 设计 / 开发
时间
2026 · 持续迭代
Feishu Whiteboard原生可编辑Workbench
01

输入

在 Codex 对话中描述参与者、阶段、节点、连线、便签和期望图形。

02

Skill 处理

提取语义 Spec,计算布局,生成同源预览与剪贴板 Payload,并完成布局自检。

03

输出

用户把剪贴板内容粘贴到飞书白板后,得到可继续编辑的节点、连线、泳道和便签。

飞书原生可编辑白板对象
04

边界

输出不是 PNG 截图。粘贴动作由用户在飞书中确认和执行,Skill 不会自行操作账户。

CHAPTER 01

第一章:从自然语言得到语义 Spec

把业务描述拆成稳定的参与者、节点、关系与视觉角色。

01

描述要画的业务链路

用户应该描述业务语义,而不是学习飞书内部剪贴板格式。

设计重点
确认图类型、泳道、节点、分支、便签和阅读方向。
阶段交付
自然语言绘图任务。
02

提取图形语义

布局前先稳定语义,才能避免图形漂亮但关系错误。

设计重点
识别参与者、动作、决策、系统、数据对象与例外路径。
阶段交付
结构化语义清单。
03

生成统一 Spec JSON

统一中间层让预览、检查和最终粘贴使用同一份来源。

设计重点
用 lanes、nodes、edges、stickies、role 和 shape 表达图。
阶段交付
可版本管理的 diagram spec。
CHAPTER 02

第二章:生成并检查可读布局

从同一份 Spec 计算几何结构、生成预览,并在交付前修复可读性问题。

04

计算可读布局

自动排布如果不理解泳道与分支,会产生交叉、遮挡和错误阅读顺序。

设计重点
按语义层级安排坐标、尺寸、锚点与留白。
阶段交付
节点几何与连接线路径。
05

生成同源预览

预览若与最终 Payload 不同源,检查通过也没有意义。

设计重点
直接从交付对象生成 SVG,保持文本、颜色、节点和连线一致。
阶段交付
用于审阅的 preview.svg。
06

执行布局自检与修复

细小重叠和双向歧义会显著降低白板的沟通效率。

设计重点
检查碰撞、越界、半重叠、反向边与异常折线。
阶段交付
自检报告和修复后的布局。
CHAPTER 03

第三章:交付飞书原生白板对象

把经过检查的结构编码到剪贴板,由用户在飞书中完成最后确认。

07

编译真实白板 Payload

ID、颜色、锚点或多层编码任一错误都可能让整图回退成文本。

设计重点
统一生成元素、关联关系、样式与剪贴板编码。
阶段交付
可被飞书识别的原生对象 Payload。
08

写入系统剪贴板

用户需要一个简单、可验证的交付动作,而不是手动导入复杂数据。

设计重点
完成环境检查、编码写入和成功反馈。
阶段交付
已装载原生对象的系统剪贴板。
09

在飞书中手动粘贴

账户内写入属于用户控制的外部操作,需要明确确认。

设计重点
提供新建画板、进入空白画布与粘贴的最短路径。
阶段交付
飞书白板中的完整图形。
能力边界
最后一步由用户在飞书中手动完成。
10

继续编辑原生对象

真正的协作交付物必须能修改文字、移动节点并延续讨论。

设计重点
确认节点、连线、泳道和便签均可独立选择与编辑。
阶段交付
不是 PNG 的飞书原生可编辑白板。

FINAL DELIVERY

最终交付是 飞书原生可编辑白板

用户把剪贴板内容粘贴到飞书白板后,得到可继续编辑的节点、连线、泳道和便签。

如何调用

在 Codex 中描述要画的流程,并要求生成可粘贴到飞书白板的原生可编辑对象。

明确边界

输出不是 PNG 截图。粘贴动作由用户在飞书中确认和执行,Skill 不会自行操作账户。

查看 GitHub 仓库