SuperAPI AI 工具集

mermaid-gen

通用与其它

查看项目

更新于 10-16 01:07

技能介绍

用途:mermaid-gen 为 AI 助手提供生成语法正确 Mermaid 图表的专家指导,重点保证图表语法正确并遵循最佳实践,避免导致渲染失败的常见解析错误。

主要能力:预防嵌套引号、特殊字符和畸形语法等错误;掌握流程图、时序图、状态机等正确写法;用模板在渲染前校验图表;系统化诊断并修复解析错误;遵循命名、样式和结构规范。

使用方式:输入图表类型(flowchart、sequence、state、class)、图表用途和内容描述;可选输入现有代码、错误信息、样式偏好和命名约定。工作流为五步:理解需求、规划节点结构、应用语法规则、按模板构建图表、校验测试。关键规则包括:节点标签不得嵌套引号;含 <br/> 与小数或特殊字符的标签整体用双引号包裹;边标签尽量不加引号;含特殊字符的子图用 ID["显示名"] 语法并在 style 中引用 ID;节点 ID 用 camelCase 且唯一;样式指令放在所有节点定义之后;提交前在 Mermaid Live Editor(https://mermaid.live)验证。

适用场景:创建新图表、修复解析错误、把文字描述转为 Mermaid、提交文档前校验语法、调试“Expecting X, got Y”错误、从其他格式迁移图表、需要节点命名与样式最佳实践时。

限制:不用于简单表格或文本列表、图表文件管理与 SVG 生成(应使用 charts-flow 技能)、数据可视化图表(柱状、饼图、折线)、甘特图或 Git 图;图表已正常工作时无需使用。避免超过 50 个节点的过度复杂图表,避免 node1、node2 等泛化 ID,避免使用已弃用语法。与 charts-flow 的关系:charts-flow 负责文件管理、SVG 生成与嵌入,mermaid-gen 负责在创建文件前确保语法正确,二者可配合使用。具体收费、价格与平台信息暂未提供。