SuperAPI AI 工具集

mermaid

设计与创作

查看项目

更新于 11-03 17:18

技能介绍

用途:该技能面向 Mermaid 图表的创建、编辑与调试,把文字描述或系统说明转换为可渲染的图表代码,也可用于修复损坏的语法、解释和可视化文档化系统。

主要能力:技能说明覆盖 20 多种图表类型,包括 flowchart(流程与决策树)、sequenceDiagram(API 交互与消息流)、classDiagram(OOP 结构与关系)、stateDiagram-v2(状态机与生命周期)、erDiagram(数据库模式)、gantt(项目时间线)、pie(比例数据)、mindmap(层级概念)、timeline(时间事件)、quadrantChart(优先级矩阵)、gitGraph(分支合并)、xychart-beta(柱状与折线)、sankey-beta(流量)、architecture-beta(系统组件)、journey(用户体验)、kanban(任务板)和 block-beta(精确布局)等;每种类型给出关键字与使用场景,并提供流程图、时序图、类图的基础语法示例。

使用方式:文档描述了一个工作流:先识别图表类型,再查阅 references/ 下对应的参考文件,随后按语法规则起草代码,检查缩进、连接和括号等常见问题并进行验证,最后按需添加样式或调整布局;调试时检查节点括号缺失或多余、箭头写法、引号匹配、特殊字符实体编码、缩进与图表类型声明等;文档还提供按用户意图选择图表类型的对照表,以及用 grep 查找节点形状、边语法、样式和配置示例的模式。

适用场景:需要绘制流程图、时序图、类图、ER 图、甘特图、饼图、思维导图、时间线、象限图、Git 图、XY 图、桑基图、架构图、用户旅程、看板和块图时;将描述转换为图表代码;修复解析错误;以可视化方式解释或文档化系统。

限制:文档说明不支持内联图片(部分图表类型的图标除外),静态渲染的交互能力有限,部分图表类型仍处于 beta(带 -beta 后缀),复杂布局可能需要手动调整,跨浏览器渲染可能略有差异;样式配置要求 %%{init: 位于图表最前并避免 JSON 语法错误。