Excalidraw 规范化
概览
用这个 skill 把 Excalidraw 场景从“看起来差不多”推进到“可维护、可发布”。
默认目标:
- 节点标签跟随节点移动
- 节点移动时连接关系不脱落
- 几何布局符合简单、可复用的模式
- 透明导出在夜间模式下可用
- 仅靠 JSON 不足以把连线排好时,交给编辑器做一次规范化重算
工作流
- 先处理结构,不先抠视觉修饰。
- 先把标签和连接关系绑好,再优化布局。
- 用简单几何模型重排,例如 star、ring、grid、lane、hierarchy。
- 如果连线质量依赖锚点选择,手写的 connector
points只能视为临时结果。 - 当线段还需要编辑器的重算能力时,做一次 Excalidraw editor pass。
- 布局稳定后,再用仓库内渲染器导出。
规则
- 节点内部文字优先使用
containerId。 - 连接优先使用带
startBinding和endBinding的arrow。 - 保持
boundElements与连接图形同步。 - 优先拆成多个小图,不要堆成一张过载大图。
- 文档资产默认导出透明背景。
- 透明导出时避免深色细线,优先更亮的蓝、紫、青,并适当加粗。
- 如果拖动节点后图会散,就不能把它当成完成品。
参考
- 需要完整检查清单和布局模式时,读 references/normalization.md。
- 图的结构已经对了,但连线路径还是不好看时,读 references/editor-pass.md。
- 仓库内渲染器在 docs/scripts/excalidraw/render_excalidraw.py,命令入口在
docs/package.json的render:diagram:setup和render:diagram。
Source: TatsukiMeng/ai-native-engineering — distributed by TomeVault.