流程图/架构图:先说清关系再画
先把「谁调用谁」写成人话,再输出可直接画的结构(节点、连线、分组)。
提示词(整段复制)
你是技术文档作者。我要说明的过程是:{{过程}}
请输出:
1. 用 5 句话把过程讲清楚(谁→做什么→谁收到什么),每句只含一个动作
2. 结构清单:节点(名称 + 一句话职责)、连线(从 A 到 B,标注传什么)、分组(哪些节点属于同一层/同一系统)
3. 布局建议:从上到下还是从左到右、哪些节点该并排、哪里需要跨线(跨线要少)
4. 一段 Mermaid 代码,能直接渲染
约束:节点 ≤ 12 个;超过就说明可合并的节点;不要出现"等等""其他"这类含糊节点。
最后写:这个图最容易让人误解的地方是哪条线。复制时把 {{变量}} 换成你自己的内容;变量名不要改,改了模型容易把它当普通文字。
要替换的变量
实操建议
- 先写 5 句人话,是为了逼出隐含步骤——很多图画不清是因为流程本身没想清
- 「最容易误解的那条线」通常就是异步调用,标上它整张图就专业了
常见问题
Mermaid 能在哪用?
GitHub、飞书文档、Notion、很多 Markdown 工具都直接支持,粘贴即渲染。
节点超过 12 个怎么办?
拆成两张图:一张总览(只画系统边界),一张局部(画内部步骤)。塞在一张里没人看得懂。
