SuperAPI AI 工具集

draw-diagram

通用与其它

查看项目

更新于 10-16 04:33

技能介绍

用途:将需求、散文、代码或现有系统转换为精良、准确的图表,并保留可编辑源文件。适用于架构、概念、组件、数据流、控制流、时序、状态、部署、网络、ER/数据模型、集成、信任边界、迁移、韧性与可观测性等视图,也可把草图或现有图表转为可版本控制的工件。若用户主要需要架构决策或完整 HLD,应先使用架构设计技能,再用本技能绘制已批准的视图。

工具选择:默认先推荐 Excalidraw,D2 为替代方案,需说明权衡,不静默替用户选择。Excalidraw 适合可编辑、协作、图标丰富、视觉表现强的图;其场景由图规格生成,不应手写场景 JSON。D2 适合简洁源文、可审阅差异、自动布局和 CLI 渲染,源为 .d2,渲染为 SVG。用户已指定工具时直接沿用。

用法要点:Excalidraw 规格置于 docs/src/<name>.diagram.json,生成场景与 PNG;命令示例为 node <skill-dir>/scripts/excalidraw/diagram.mjs docs/src/system_context.diagram.json --scene docs/src/system_context.excalidraw --png docs/assets/system_context.png --scale 2 --padding 32。D2 需先检查 d2 version、d2 layout,由用户选择引擎(如 ELK、Dagre、TALA)并用 --bundle=true 渲染。非原生图标统一从 Iconify 获取,HTTPS 地址形如 https://api.iconify.design/{prefix}/{name}.svg,并记录来源与许可;图标应本地化,不得在图中保留运行时 URL。

限制:只做绘图与修订,忠实呈现给定设计,不臆造组件或流程;含义不明时应询问。成功命令不等于合格,必须检查渲染结果并迭代。构建警告视为缺陷,不可带警告交付。输出须位于运行目录下,构建器拒绝写入符号链接。D2 缺失时需用户自行安装或改用 Excalidraw。字体、浏览器、渲染器版本等可固定以保证可复现。编辑器往返修改是有损的,需把手动修改回填到规格。若上述工具链不可用,可改用其他渲染方式,但须在交付说明中注明。