用途:根据自然语言描述生成 Excalidraw 图表,并端到端导出为 PNG 或 SVG 图片。适用于创建流程图、架构图、思维导图、关系图、时序图、ER 图、类图、泳道图和数据流图等。
主要能力:按“理解需求→生成 .excalidraw JSON→导出 PNG/SVG→交付结果”的流程工作。生成时要求所有文本元素使用 fontFamily: 5(Excalifont)以保留手绘风格,代码标识可用 fontFamily: 3(Cascadia);ID 必须唯一,建议元素数不超过 20,水平间距 200-300px、垂直 100-150px。提供配色建议:主实体 #a5d8ff、流程步骤 #b2f2bb、重要/中心 #ffd43b、警告/错误 #ffc9c9、默认描边 #1e1e1e。
使用方式:首次使用先运行 bash <SKILL_DIR>/scripts/setup.sh 检查依赖,需要 Python 3.8+、resvg、fonttools + brotli 以及联网访问 kroki.io;可选 Google Chrome 作为回退。可用 python3 <SKILL_DIR>/scripts/export.py --preflight 验证依赖。导出命令示例:python3 <SKILL_DIR>/scripts/export.py <file>.excalidraw(默认 PNG 2x)、-f svg、-f png -f svg、-o output.png、--scale 3、--dark。交付时同时提供导出图片、源 .excalidraw 文件和简要说明。
限制:需要联网(kroki.io 渲染 SVG);建议每图不超过 20 个元素;自动生成不支持嵌入图片;手绘粗糙度使用默认设置。若 kroki.io 不可达,只能输出 .excalidraw 并提示用户手动导出;缺少 fonttools/brotli 会回退到 Chrome 或系统字体;CJK 显示为方框时需使用 fontFamily: 5 并安装 fonttools+brotli。