用途:该技能用于编写人类可读、且便于智能体解析的 Mermaid 图表,提供在旧版渲染器(VS Code/Markdown 预览、Git 平台)上也能正常渲染的保守模板,并指导在不同场景下选择合适图表类型。
主要能力:包含流程图、时序图、类图、状态图、ER 图、用户旅程、甘特图、饼图等可用模板;对 quadrantChart、sankey-beta、requirementDiagram、gitGraph 等高级类型提供流程图降级方案;并给出兼容性规则与排错建议。
兼容性规则:流程图优先用 graph LR/graph TB,部分渲染器不支持 flowchart 关键字;含空格或特殊字符的标签需加引号,如 A["Text (x|y) |"];标签内不要用字面 \n,换行用 <br/>;代码围栏须从第 0 列开始并标注 mermaid。
ASCII/Unicode 旁注:每个 Mermaid 块下方必须附一个用 text 围栏的纯文本图,二者节点、边与标签保持同步,若不一致以 Mermaid 为准;宽度建议约 80 列,优先用 ASCII 线稿,可选 Unicode 制表符;可在图对上方加一行说明,如 Diagram: <name> (<type>)。
使用方式:按场景选类型——流程图用于一般流程与决策,时序图用于交互时序,类图用于领域模型,状态图用于生命周期,ER 图用于数据模型,旅程图用于用户体验,甘特图用于排期,饼图用于简单占比;高级类型不可用时改用提供的流程图降级模板。
限制与排错:若渲染失败,可将 flowchart 换成 graph 并简化形状、给节点文本加引号,或在 mermaid.live 中隔离环境问题,必要时回退到上述模板。资料未提供安装命令、收费与平台支持等细节。