一键流程图生成技能
将用户的步骤、判断、输入输出和处理结果整理为可渲染的 Mermaid 流程图。
执行规则
- 第一次渲染前检查
mmdc:command -v mmdc && mmdc --version。 - 未安装时先引导执行
npm install -g @mermaid-js/mermaid-cli,未获明确授权不要代装。 - 本机版本距离 npm 最新版本超过 3 个发布版本时,先询问升级或继续使用旧版本。
- 用户没有指定保存位置时,将
.mmd和导出文件保存到当前项目的docs/mermaid/。 - 渲染失败时区分 Mermaid 语法错误和 Puppeteer 浏览器依赖错误。
- 交付时提供源码、导出文件的绝对路径链接和
mmdc版本。
图表选择
- 普通步骤使用
flowchart TD。 - 横向链路使用
flowchart LR。 - 判断使用
{},处理使用[],外部输入输出使用带引号的节点文本。 - 多角色流程使用
subgraph区分边界。
模板
flowchart TD
开始([开始]) --> 输入[/接收输入/]
输入 --> 判断{是否通过}
判断 -- 是 --> 处理[执行处理]
判断 -- 否 --> 修改[返回修改]
修改 --> 输入
处理 --> 结束([结束])
输出要求
优先生成中文短标签,避免节点文本过长;先保存源码,再使用 mmdc -i 输入.mmd -o 输出.svg 渲染。默认输出目录不存在时先创建;用户明确指定位置时按用户要求保存。