一、前言
接手老项目时，如果跳过理解环节，直接借助 AI 生成代码来迭代功能，往往会因为上下文缺失而引发各种隐蔽问题。真正正确的打开方式是：“人依旧是主导，AI 作为高效辅助”。先利用 AI 快速梳理项目脉络，再人工拆分需求、评估迭代可行性、确定具体技术方案，最后才让 AI 生成代码。 因此，让 AI 根据项目自动生成“架构图、模块图、依赖图”，便成为迭代工作的第一步。这三张图能帮开发者快速建立整体认知，大幅降低理解成本。
完整提示词，请后台私信留言“提示词”三个字
二、安装 Skill
推荐通过 claude-mermaid 这个 Skill 来在 AI 助手内生成图表。首先在终端执行全局安装：
npm install -g claude-mermaid
然后在对话界面依次执行以下命令，添加并安装插件：
/plugin marketplace add veelenga/claude-mermaid
/plugin install claude-mermaid@claude-mermaid
使用该 Skill 可以快速生成 Mermaid 格式的图表，基本覆盖架构图、模块图、依赖图等常见场景。 如果需要绘制更复杂的图形，或者将其用于最终交付文档，建议改用 draw.io，效果更佳。此外，draw.io 支持直接导入 Mermaid 代码，你可以在 draw.io 的可视化界面中，对导入的图表进行手工微调，兼顾效率与美观。
备用资源：https://github.com/imxv/Pretty-mermaid-skills
三、生成三个视图
此处以 Spring AI Alibaba Admin 项目作为演示，说明三类图的具体含义。
- 架构图 解决“这个项目整体长什么样”的问题。它描述系统的边界、对外接口以及调用关系，属于系统级总览，用于快速把握服务的拓扑结构和核心组件。
image.png
-
模块图 解决“这个项目是怎么组织的”问题。它展示内部模块的划分、职责及模块之间的依赖关系，属于代码级总览，方便理解代码分布，支撑需求拆分与改动影响评估。
image.png
-
依赖图 解决“项目依赖了哪些外部资源”的问题。它梳理了用到的第三方类库、中间件、外部 API 等，属于生态级总览，清晰展示系统与外部的耦合点，对技术选型和风险排查很有帮助。
image.png
四、结论
- 三张图通常很难一次性生成完美，务必结合实际项目进行 review。可能会遗漏某个模块，或样式、关系不够准确，人工校验与调整必不可少。
- 将三张图沉淀下来，统一放入
docs/目录。它们是生成claude.md（AI 理解项目的前置资产）的重要输入，能让 AI 更准确、更全面地理解项目。 - 出图效果与所选模型的能力密切相关。经测试，在 DeepSeek-V4 与 MiniMax 2.7 中，DeepSeek-V4 的表现更好，生成的结构更贴近实际。
- 为了让生成的图表样式更美观、更稳定，建议先向 AI 提供一个示例图片作为参考，并在提示词中明确说明“参考示例图片的风格生成”，这样可有效降低随机性，大幅提升图表的可用性与一致性。
