用途：根据描述或数据创建各类 Mermaid 图表，为可视化需求选择合适图表类型，将文字决策树改写为流程图，建模系统架构、协议、状态机、数据模型，或将时间知识编码为时间线图。不适用于将 Mermaid 渲染导出为 PNG/SVG/PDF、ASCII 艺术或 GUI 设计工具。
主要能力：支持 23 种图表类型，包括 flowchart、sequenceDiagram、stateDiagram-v2、erDiagram、timeline、mindmap、gantt、pie、quadrantChart、gitGraph、classDiagram、journey、sankey-beta、xychart-beta、block-beta、architecture-beta、kanban、requirementDiagram、C4Context、packet-beta、radar、treemap、zenuml。提供图表类型选择指引、流程图方向与节点形状、边样式、子图、时序图消息与块、状态图、ER 图基数与属性等语法参考。
使用方式：依据内容结构选择图表类型；流程图方向可选 TD/TB、LR、BT、RL；节点形状如 [text] 矩形、(text) 圆角、{text} 菱形、([text]) 药丸形等；边样式如 -->、---、-.->、==>、--text-->、~~~。时序图消息用 ->>、-->>、-)、-x，块用 activate/deactivate、alt/else/end、loop/end、par/and/end 等，可加 autonumber。状态图用 [*] 表示起止，支持嵌套状态与 fork/join/choice 伪状态。ER 图基数如 ||--||、||--o{、}o--o{、||--|{，属性可标 PK、UK、FK。
写作原则：使用描述性标签而非代码；全图方向一致；每图最多约 15 个节点，超出则拆分或使用子图；用子图分组；决策菱形出边必须加标签；主流程用实线箭头，可选/异步用虚线，关键路径用粗箭头，~~~ 仅用于布局调整。
限制：不负责渲染导出；不生成 ASCII 艺术；不涉及 GUI 设计工具。参考资料包括 references/diagram-types.md 和 scripts/validate_mermaid.py，后者可校验任意文件中的 Mermaid 语法。