图表

设计、创建、审查和转换图表，同时保持视觉论证和原生源文件独立正确。

解决两个决策

首先选择表达关系的视图：流程图、序列图、状态图、架构图、数据模型、层级图、时间线、比较图或其他支持的视图。然后选择交付格式。不要让熟悉的文件格式决定图表类型。

当显式格式能够表达所需结构时，优先使用该格式。如果它造成了实质性限制，则解释该限制并提供替代方案，而不静默地更改交付物。

当格式未指定时，使用此矩阵：

约束条件	Excalidraw	Mermaid	draw.io
手动坐标控制	强	弱；布局自动	强
协作可视化编辑	Excalidraw 中强	取决于宿主环境	diagrams.net 中强
文本差异和代码审查	差	强	未压缩 XML 中中等
自动布局	手动优先	强	可用，但手动几何仍保持显式
自由空间组合	强	有限	强
页面、图层、容器、形状库	有限	有限，且依赖于渲染器	强
直接 Markdown/聊天渲染	罕见	若支持则强	罕见
交付后的原生可编辑性	`.excalidraw`	兼容编辑器中的 Mermaid 源	`.drawio` XML
可靠的验证和渲染	需要检查器加忠实渲染器	需要目标解析器加渲染器	需要 XML 检查加兼容编辑器/导出器

优先选择原生编辑器、验证器和渲染器在交付环境中可用的格式。如果没有任何格式能提供视觉证明，则仅在仍有价值时生成请求的原生源，并将结果标记为 DEGRADED。

确定单一问题、受众、交付视口、入口点和主导阅读方向。在缩短解释性标签时保留精确的事实和标识符。在语法或坐标之前建模语义节点、边界和关系。

在创建或实质性修改图表之前，阅读共享设计方法。它拥有拓扑、层次、密度、分组、边界、布线、语义形状/颜色/线条使用、拆分标准和视觉接受度的决策权。

格式适配器拥有序列化、转义、标识符、绑定、几何、主题、页面、图层和渲染器特定限制的决策权。不要将其易变的机制复制到此核心中。

对于新的命名路径交付物，首次写入时请求的路径成为规范路径。对于修订，现有源文件保持规范，而更改位于候选文件中。编辑器和渲染器使用这些构件；导出到其他地方永远不会隐式取代规范源文件。

修订候选文件仅在满足完成门控时才替换现有源文件。否则报告 DEGRADED，保持现有源文件不变，并将候选文件标识为未完成。

在转换中保持语义一致性：节点含义、关系方向、序列、包含、边界、基数以及精确的技术标记。当源和目标都支持时，保留页面、图层和容器标识。说明自动布局更改、不支持的形状库或扁平化样式等损失；永远不要承诺像素级一致。

对于仅审查工作，检查并报告，不重写。分别检查原生结构和渲染构图：解析成功不能证明可读性，合理的图片不能证明可编辑性。

此技能拥有显式 x9-diagrams 调用、格式选择、跨格式转换、共享视觉方法以及结构加视觉综合验证的决策权。仅限于普通 Mermaid 语法的请求可以保留给已安装的专业 mermaid-diagrams 技能。此技能对没有该第三方技能的用户保持自包含。

当触发所有权不明确时，仅当任务需要更广泛的决策或验证合约时才使用 x9-diagrams。不要仅仅因为请求中出现 Mermaid 就同时调用两个技能。

将完成证据与请求的动作匹配：

格式选择： 命名视图和交付格式，将选择与用户的约束条件联系起来，说明实质性限制，并确定兼容的验证器、渲染器或编辑器是否可用。
创建或实质性修订： 所选视图回答了所述问题；原生源文件解析或打开并保持可编辑；代理没有触发其自身无法完成的原生文件或目录选择器；格式特定的加载后布局在适用处稳定；兼容的渲染器或编辑器从最终修改后的规范源文件生成了实际视图；并在声明的交付模式下检查了该视图的可读性、层次、交叉、裁剪和误导结构。
转换： 满足创建证据并确认重要的语义得以保留；说明布局、样式、页面、图层、容器或符号方面的任何损失。
仅审查： 区分原生结构发现与渲染构图发现，并引用检查的证据，不重写构件。

如果无法获得活动动作所需的任何证据，则报告 DEGRADED，并说明确切缺失的检查、验证器、渲染器、编辑器或源构件。Excalidraw 检查器回归测试位于 scripts/test_check_scene.py。