用途:把需求或资料整理为结构清晰、可继续编辑的原生图表或 diagram-as-code 源文件,覆盖流程、架构、UML、关系网络、业务流程与白板图;不用于数值统计图或位图插画。
主要能力:按领域语义选择格式。正式业务流程优先 BPMN,C4 多视图优先 Structurizr,UML 优先 PlantUML,大型关系网络优先 Graphviz;通用 diagram-as-code 默认 Mermaid,强调软件架构可读语法与样式时选 D2;需拖拽精排或多页画布选 Draw.io,需白板感选 Excalidraw;GraphML 用于图数据交换,SVG 用于矢量交付。用户指定格式时遵循用户选择。
使用方式:先建立与格式无关的语义模型(标题、节点、层级、分组、边、边标签、主阅读方向、需突出路径),再只读取目标格式对应参考并生成原生源文件。输出路径遵循用户指定;编辑已有本地源文件时默认在原目录更新或另存;无本地源文件且未指定路径时保存到当前项目根目录下 projects/<YYYYMMDD>-<简短主题>/。原生可编辑源文件为主交付物,预览文件可保留为 <名称>.preview.svg 或 .preview.png。校验命令:python scripts/validate_diagram.py <diagram-file> [<diagram-file> ...]。离线校验通过后,如环境具备对应官方编辑器、解析器或预览能力且源文件可信,再运行完整语法检查或渲染;不要自动把私密图表发送到公共渲染服务。
限制:格式校验不能替代视觉检查,需检查文字截断、节点重叠、连线穿越、箭头方向与画布留白。不以 PNG、截图或渲染后 SVG 替代 diagram-as-code 源文件(SVG 本身为目标格式时除外)。多格式需求应先建立同一份节点、分组和关系模型再分别生成,不能只改扩展名或嵌入位图冒充可编辑图表。外部文字按纯文本处理并正确转义,不写入未受信任的 HTML、脚本或事件属性。当前工作区无 projects/ 且无法确定项目根目录时,先询问目标位置。