过去,绘制一张系统架构图往往意味着打开 Visio 或 PowerPoint,花费数十分钟调整连接线、导出 PNG,再嵌入文档。如今,开发者可以通过自然语言描述系统结构,让 Claude Code 自动生成 Draw.io 格式的架构图。借助 Draw.io MCP Server,这一过程无需手动拖拽,也无需 Visio 授权,输出结果还能直接纳入版本控制。
从自然语言到 Draw.io 文件
Draw.io MCP Server 可在本地运行,并基于 mxGraphModel XML 渲染图表。Claude Code 通过 MCP 协议与该服务器连接,将用户对系统的文字描述转换为有效的 Draw.io XML。生成的图表可在浏览器中打开审查,随后保存为 .drawio 文件,直接放入代码仓库的 /docs 目录。
文章提到,对于多数图表而言,整个流程通常不到一分钟即可完成。相比之下,在 Visio 或 Lucidchart 中手动绘制类似图表通常需要 30 分钟以上。作者认为,这种方式的优势不仅在于速度,还在于输出结果是可版本控制的 XML,能够通过 git diff 融入“活文档”体系。
适合生成哪些图表
素材展示了一个具体示例:用户向 Claude 描述一个以 Dynamics 365 CE 为核心的集成架构,要求其连接 Azure AI Search、外部 ERP、Power Automate、Dataverse 审计日志和 Power BI,并指定不同颜色用于 Azure 服务、D365 和外部系统。约 30 秒后,Claude 生成了一张带有连接标签、颜色分类和图例的架构图。
文章还展示了一个用于绩效评审流程的泳道图,其中包含四个泳道、决策网关和系统自动化步骤。作者总结,Claude 较适合处理结构清晰、组件关系明确的技术图表,例如:
- 系统架构图
- 集成架构图
- 泳道流程图
- 后续可拓展的 ERD 场景
80/20 工作法:AI 先完成大部分
作者将其概括为“80/20 规则”:Claude 可在 30 秒内生成图表的 80%,开发者再用约 5 分钟处理剩余 20%,例如调整布局、优化标签位置等。总耗时约 6 分钟,明显低于从零开始绘制的 30 分钟以上。
为了提高生成质量,文章建议用户给出更具体的提示,而不是简单说“画一张架构图”。例如,可以明确系统之间的连接方式、协议、调度频率、颜色分类、图例位置和整体布局方向。上下文越充分,输出越准确。对于 Dataverse 项目,还可以将 XrmToolBox 导出的 schema 提供给 Claude,用于生成更准确的 ERD。
对技术文档工作流的意义
Draw.io 与 Claude Code 的组合在成本、AI 生成能力和 git 友好性方面具有优势:Draw.io 免费,Claude 可从文本生成完整图表,XML 格式便于版本管理。不过,文章也指出其短板在于实时协作能力较弱,团队更多通过 pull request 协作,而不是多人同时编辑。
对于架构师、解决方案顾问和平台团队而言,这种工作流的价值不只是“画图更快”,而是让技术图表更容易随代码和文档一起维护。当架构图成为仓库中的可追踪文件,文档更新不再是一次性交付物,而更接近持续维护的工程资产。
原创文章,作者:点点,如若转载,请注明出处:https://www.dian8dian.com/jia-gou-shi-de-xin-gong-zuo-liu-yong-claude-code-he-draw-io