AI 写代码太快跟不上？这个 Skill 让它顺手把架构图也画了

你有没有过这种体验：AI 三秒钟把代码写完，你花三个小时才搞明白它到底干了啥？

这就是我最近最头疼的事。Claude Code、Cursor 这类 Agent 工具是猛，但产出太快了，快到你根本来不及理解。等你下次回头维护这个项目，它已经变成一个连你自己都读不懂的黑盒。

直到我装上 oh-my-mermaid（omm）。

它到底干什么

一句话：让 AI 帮你把整个代码库自动拆成一套可点击的架构图。

你跑一句 /omm-scan，AI 会从根目录开始扫描，每一层都生成 Mermaid 图和说明文档。复杂节点会被递归拆开，自动嵌套成子图；简单的就直接是叶子节点。出来的目录长这样：

.omm/
├── overall-architecture/   ← perspective
│   ├── diagram.mmd
│   └── main-process/
│       └── auth-service/   ← 更深一层
└── data-flow/
└── external-integrations/

每个节点最多带 7 个字段：description、diagram、context、constraint、concern、todo、note——基本上就是一个工程文档的最小可用集。然后 omm view 直接起一个交互式浏览器帮你看，复杂模块能展开，简单模块就是点。

为什么程序员该装

• 一次扫描，自动按视角拆分：架构、数据流、外部集成……不同 lens 看同一份代码，比人脑手动整理快 100 倍
• 跨平台：Claude Code / Codex / Cursor / OpenClaw / Antigravity，一个命令全装上 (omm setup 自动识别)
• 可推云端：本地看完想跟同事共享，omm push 一键扔云，私密默认 + 可选公开
• 全 TypeScript，2191 ⭐，MIT，活跃维护（昨天还在更新）

我自己用下来的体感：以前 onboard 一个新代码库要两天，现在先跑 omm scan + omm view，半小时心里就有谱了。改老代码前先用它画一遍数据流，比翻 PR 历史靠谱。

怎么上手

npm install -g oh-my-mermaid && omm setup

然后在你用的 AI 编程工具里调 /omm-scan，等它跑完再 omm view 看结果。整个流程不到一杯咖啡的时间。

GitHub 仓库：oh-my-mermaid/oh-my-mermaid

GitHub: https://github.com/oh-my-mermaid/oh-my-mermaid