SuperAPI AI 工具集

mermaid-diagrams

智能体与模型

查看项目

更新于 10-15 20:24

技能介绍

用途:本技能是一份 Mermaid 图表编写指南,目标是产出既方便人阅读、又便于智能体解析的图表,并给出保守、兼容渲染器的模板与选型建议。

主要能力与规则:优先用 graph LR/graph TB 画流程图,部分渲染器不支持 flowchart 关键字;含空格或特殊字符的标签要加引号,如 A["Text (x|y) |"];标签内不要用字面 \n,换行用 <br/>;quadrantChart、sankey-beta、requirementDiagram、gitGraph 等高级类型可能不可用,需用提供的流程图回退方案;代码围栏须从第 0 列开始并标注 mermaid。

ASCII/Unicode 旁注:每个 Mermaid 块下方必须紧跟一个纯文本、等宽字体的旁注图(用 text 围栏),与 Mermaid 保持节点、边和标签同步,若不一致以 Mermaid 为准;宽度建议约 80 列,优先用 ASCII 线条,可加一行标题。

模板覆盖:流程图、时序图、类图、状态图(v2)、ER 图、用户旅程、甘特图、饼图,以及象限图、需求图、桑基图、Git 图的流程图回退写法。

选型建议:流程图用于一般流程与决策;时序图用于随时间发生的交互;类图用于领域模型;状态图用于生命周期;ER 图用于数据模型;旅程图用于用户体验;甘特图用于排期;饼图用于简单占比;象限图回退用于优先级矩阵;需求图回退用于需求追踪;桑基图回退用于相对流量;Git 图回退用于小型分支合并 DAG。

排错:渲染失败时可把 flowchart 换成 graph 并简化形状、给节点文本加引号,或在 mermaid.live 中隔离环境问题,必要时回退到上述模板。

限制:资料未提供安装命令、收费、平台支持范围等具体信息。