Mermaid Flow Image Skill

适用场景

• 用户要求：

• “生成 mermaid 流程图”

• “简化流程图”

• “详细中文版本”

• “导出图片并发送”

输出策略

• 先结构化：把流程拆成阶段（输入 / 路由 / 处理 / 状态 / 异常）。

• 再选粒度：

• 简化版：≤ 12 个节点，突出主路径。

• 详细版：按子图（subgraph）分层，覆盖关键分支与状态回写。

• 中文优先：节点文案用中文，技术关键词可中英混排。

• 可渲染优先：

• 节点文字尽量加引号，避免 Mermaid 保留字符导致解析失败。

• 避免在节点内直接使用未转义的 < > / 组合。

图片导出规范

• 默认输出路径：./media/images/<name>.png

• Mermaid 源文件：./media/images/<name>.mmd

• 使用脚本：./scripts/python/render_mermaid_kroki.py

• 高分辨率：将 scale 设为 2 或 3

示例命令（Python 方式）：

python3 ./scripts/python/render_mermaid_kroki.py
./media/images/rpc-flow.mmd
./media/images/rpc-flow.png
3

Mermaid 模板（详细中文）

flowchart TD A["输入消息"] --> B["会话路由"] B --> C{是否命中复用进程} C -->|是| D["复用并继续处理"] C -->|否| E["新建进程并初始化"] D --> F["流式事件"] E --> F F --> G["状态持久化"]

交付检查清单

• Mermaid 语法可渲染

• 中文标签清晰无歧义

• 主分支与异常分支都可见

• 产出 PNG 并成功发送