你好，我是拉克先生（Mr Lark）。AI 写代码越快，我越不想先看代码。

代码和 Plan 都会变长

以前顺着文件看逻辑就行：入口在哪，数据怎么传，最后在哪渲染。

现在 AI 改一次功能，可能同时动路由、组件、样式、数据脚本和配置。每个文件单独看都懂，合起来像一张网。看完代码还是不知道改动边界在哪。

Plan 也没好多少。复杂任务里，代码复杂度被翻译成了文字复杂度。

所以我现在先看图。

按问题拆图

Mermaid 简单场景够用，复杂了就乱——节点多了箭头互相穿插，分组多了图越拉越宽。

后来我用 PlantUML，按问题类型选图：

  • 看调用顺序 → sequence diagram
  • 看模块关系 → component diagram
  • 看状态变化 → state diagram

先让 AI 画图

我现在通常让 AI 先生成：

先用 PlantUML 画一张图，说明这几个文件之间的调用关系。
如果涉及状态变化，再单独画一张 state diagram。

图能帮我快速判断入口在哪、数据从哪来、哪些地方可能互相影响。图看懂以后，再决定要不要看代码。

docu.md 负责渲染

PlantUML 写在 Markdown 里好维护，但普通预览不一定能渲染。docu.md 的浏览器插件可以渲染 PlantUML，也支持 Mermaid、Graphviz、LaTeX。

现在我会让 AI 生成一个 doc.md，放任务背景、关键文件、PlantUML 图和少量说明。浏览器打开，看图、扫标题、再回代码。

我不再从代码细节开始，也不再从一长段 Plan 开始。我先看图。