用途:mermaid-gen 为 AI 助手提供创建语法正确 Mermaid 图表的指导,重点在于避免导致渲染失败的常见解析错误,并遵循最佳实践。
主要能力:防止嵌套引号、特殊字符和畸形语法等错误;掌握流程图、时序图、状态机等正确写法;用模板在渲染前校验图表;系统化诊断并修复解析错误;遵循命名、样式和结构规范。
使用方式:按五步流程操作——理解需求、规划节点结构、应用语法规则、用模板构建图表、校验测试。关键语法规则包括:节点标签不得嵌套引号;含 <br/> 与数字或特殊字符的多行标签需整体用双引号包裹;边标签尽量不加引号;子图含特殊字符时用 ID["显示名"] 语法并在 style 中引用 ID;节点 ID 与显示标签分离,ID 用 camelCase;样式指令放在所有节点定义之后;每行只写一条语句。完成后在 Mermaid Live Editor(https://mermaid.live)测试,并用 mermaid-gen/encode-link.ts 生成链接,除非明确要求否则只返回链接。
适用场景:创建新图表、修复解析错误、将文字描述转为 Mermaid、提交文档前校验语法、调试“Expecting X, got Y”错误、从其他格式迁移图表。
限制:不用于简单表格或文本列表、数据可视化图表(柱状/饼图/折线)、甘特图、Git 图、带照片的组织架构图;不负责图表文件管理与 SVG 生成(由 charts-flow 技能负责);避免超过 50 个节点的复杂图;不使用已弃用语法。具体收费、价格与平台信息暂未提供。