mermaid

聊天机器人的 Mermaid 图表

使用此技能创建可在 Markdown 聊天界面中良好呈现的 Mermaid 图表，在本地验证其语法，并在不调用 Web 服务的情况下渲染图像。

调用提示

• 使用此技能时，请告知用户技能名称：mermaid。

工作流

1. 根据请求确定图表类型（flowchart、sequenceDiagram、stateDiagram-v2）。
2. 在使用 mermaid 的 Markdown 围栏代码块中起草 Mermaid 代码。
3. 遵循 references/chatbot-mermaid-guidelines.md 中的格式规范。
4. 使用 scripts/validate_mermaid.py 验证图表。
5. 如果用户需要图像文件，使用 scripts/render_mermaid.py 进行渲染。

脚本

• scripts/validate_mermaid.py
  • 调用本地 Mermaid CLI（mmdc）验证 Mermaid 代码。
  • 需要检查 Mermaid 是否能无错误解析时使用。
• scripts/render_mermaid.py
  • 使用本地 Mermaid CLI（mmdc）将 Mermaid 渲染为 SVG/PNG/PDF。
  • 需要嵌入图像时，Markdown 渲染器优先使用 SVG。

备注

• 这些脚本要求 PATH 中包含 mmdc（Mermaid CLI）。 如果缺少该工具，请指导用户在本地安装；不要使用 Mermaid Web 服务。
• 依赖项通过各 Python 脚本中的内联 uv 脚本元数据进行管理。 需要时，使用 --install-chromium 通过 pyppeteer 安装 Chromium 二进制文件。
• 图表应简洁易读，适合在聊天界面中查看：避免图形过宽，使用简短标签，并将相关状态分组。
• 如果用户要求原始 Markdown，只返回围栏代码块中的 mermaid 内容，除非用户要求补充说明。