AI 画架构图别只会 Mermaid：一个可小修、能进 Git 的手绘风 Agent Skill

改了 5 轮，图还是不对

最近几次给非技术同事讲流程，卡的不是内容，是图。

有一版我用 Mermaid。节点写得清楚，对方看完只记住一排方块。我换成白板，第一眼舒服多了。下一轮同事说「这里再强调一下风险」，图标、业务物件、那个变窄变厚的形状都不好动，我只好整张重画。前后大概 5 轮。

我想要的其实很小：人看得懂，别太工程师，改一处不用从头来。

第一版不难，第二版才烦

白板，或者直接让 AI 出一张图，第一版常常能看。烦的是后面。自定义弱，个性化图标和业务物件很难说改就改。

Mermaid 能进文档，能改文字，也能进版本管理。工程师之间传没问题。拿去汇报，讲给非技术同事，就硬了。

我给自己记过要求：看起来别像一堵拓扑墙，改标注、挪节点别整图重来。还得能画「包裹」「人」「特征变窄变厚」，不能永远是 Box1 指向 Box2。

还有一笔账。AI 把想法画成第一版很快，可每次微调都重画一遍，Token 实在肉疼。

后来写成了一个 Agent Skill

于是有了 sketch-infographic，我叫它「手绘信息图」。

开源的 Agent Skill。装好直接说要什么图，Agent 去选型、画图。出来是一张手绘图，也能存成普通图片。

第一版交给 AI。后面改颜色、改标注，我在本地重渲，不再去调图像模型。

我现在大概是这么用的：

1. 口述「把这个流程讲清楚」
2. Agent 画出第一版手绘图
3. 下一轮只改颜色、标注和位置，让它重画这一处
4. 改动留得下来。画错了还能退回上一版

全量重画才费 Token。平常我只动要改的那一处，再让它重画一遍。

他们记住的是「包裹」，不是步骤名

只画方框连线，Mermaid 够用。我还是想要自定义，因为非技术同事记不住「步骤 C」，记得住图上那个「包裹」，还有那个人。

skill 里我写了默认倾向：别一上来就排一排等宽卡片。读者要看形态怎么变，就用圆、叠层，或者补一个自己的形状。要看谁依赖谁，再用方框。常用图标是内置的。遇到业务里才有的物件，让 AI 画一个补进去就行。

教人画架构图的文章，我看到的大多是「用 Mermaid」或者「打开白板」。我是被那 5 轮汇报图逼的，才做成现在这样：看起来像手绘，图能改、能留版本，第一版让 AI 画，之后小修不用整张重来。

先说它干不了什么

大规模数据探索、能点能筛的统计图，别找它。照片级插画和封面也不是这份工作。团队已经统一 Mermaid，而且只要最简流程，就继续用 Mermaid。

我拿它画的是研究框架、教学示意、服务拓扑、业务路径、架构汇报。这些图要讲给别人听，而且一定会改很多轮。

装上这个 skill，直接让 Agent 画就行。打算一直改的图，把图留在项目里。之后改颜色、改标注、留下这一版，跟改一份文档一样。

这是第一篇构建日志。我先用它扛自己的汇报。哪张图改起来还别扭，再往 skill 里补。