SuperAPI AI 工具集

drawio-agents-code-validator

智能体与模型

查看项目

更新于 10-15 22:17

技能介绍

用途:本技能定义了一套针对 Draw.io mxGraph XML 的 8 阶段校验流水线,应在每次向用户展示图表或保存为文件之前运行,按严重程度先报告阻断错误、再报告警告。

主要能力:阶段 1 XML 良构性(阻断)、阶段 2 结构检查(阻断)、阶段 3 ID 唯一性(阻断)、阶段 4 父子完整性(阻断)、阶段 5 样式校验(警告)、阶段 6 几何检查(警告)、阶段 7 连接校验(警告)、阶段 8 周长检查(警告)。若阶段 1 失败,阶段 2-8 无法运行;若阶段 2 失败,阶段 4-8 结果不可靠。阶段 3-8 彼此独立,无论其他警告阶段结果如何都会运行。

必要用法:始终运行全部 8 个阶段,不得跳过;阶段 1-4 任一失败即停止并修复,不得交付未通过阻断阶段的 XML;每处错误都必须给出修复方式,不得静默修复;始终校验完整文件而非片段。报告按严重性排序,包含位置、错误和修复,并给出 SUMMARY 与 AUTO-FIXED 列表。最小有效结构为 mxfile > diagram > mxGraphModel > root,root 内需有 mxCell id="0" 与 mxCell id="1" parent="0";每个内容单元需有唯一 id、指向已存在单元的 parent、vertex="1" 或 edge="1"、至少含 html=1 的 style,以及 mxGeometry as="geometry"。

适用场景:在生成、编辑或保存 Draw.io 图表后,作为交付前的质量门禁使用。

限制:阶段 5-8 为警告,不阻断交付;部分样式属性、形状名、边样式与箭头名的清单为非穷尽列举。与 drawio-errors-xml、drawio-errors-rendering、drawio-core-xml-format、drawio-syntax-styles、drawio-syntax-connections 等技能配合使用。完整参考、工作示例与反模式见原文提供的参考链接,具体 URL 暂未提供。