用途:从文本描述、图片/截图或 Excel 生成 draw.io 可编辑图表,覆盖架构图(Azure、AWS)、流程图、泳道图、时序图,以及编辑现有 .drawio 文件中的 Azure/AWS 图标。当结果需要后续在 draw.io GUI 中编辑、使用云图标或作为文档资产时选用。
主要能力:编排三智能体工作流(分析 → 清单 → SVG 生成),流程为 USER INPUT → ORCHESTRATOR → MANIFEST GATEWAY → SVG FORGE → COMPLETED。输出格式包括 .drawio(原生格式,推荐)、.drawio.svg(SVG + 元数据,用于 Markdown/Web)、*.drawio.png(PNG + 元数据)。输出目录为 outputs/。若用户要求可编辑图表,应以 *.drawio 为主要交付物。
使用方式:前置条件为 VS Code、Draw.io Integration 扩展、GitHub Copilot。可直接提出需求,例如创建登录流程图、生成 Azure Hub-Spoke 架构图,或从 inputs/requirements.md 创建系统图。质量门评分 85-100 继续,70-84 修复重试,50-69 简化,0-49 询问用户。限制:清单修订 2 次、SVG 修订 2 次、总超时 45 分钟。
适用场景与限制:适合需要 GUI 编辑、云图标或文档交付的图表。不适合快速内联图(Mermaid 更合适)、无需手动调整的一次性文本图、需要精确坐标轴/数据绑定/排版的图表、跨平台字体渲染需一致的多语言标签、交互或动画 HTML 图,以及 Mermaid 美化(超出范围)。Azure 图必须使用已验证的 img/lib/azure2/**/*.svg 图标路径,保留简短服务标签,图标缺失或误导时回退为中性方框。生成图片仅作可选布局参考,不作为需求证据;需在清单中确定标签、节点、分组和边方向,遇到歧义应标记而非编造内容。
参考文件包括 mxcell-structure.md、cloud-icons.md、style-guide.md、delivery-patterns.md、troubleshooting.md;脚本 scripts/validate_drawio.py 用于验证 mxCell 结构。常见问题:draw.io 中空白需检查 content 属性;边不可见需核对节点 ID;图标缺失需启用 Azure/AWS 形状;外框附近文字重叠可内缩顶部标注 16–24px、增加高度、换行至 3–4 行,并按实际嵌入宽度检查。完成标准包括生成 .drawio 或 .drawio.svg、在 VS Code Draw.io 扩展中正确打开、节点与边可见、质量门评分 ≥ 85,并在目标嵌入宽度下完成渲染审查。