项目架构图过时或缺失是常见痛点。通过创建 Claude 技能，可实现自动化分析代码库并生成 Excalidraw 架构图，让文档与代码版本同步，彻底告别手绘更新的繁琐。
智能速览
利用 Claude Code Skill 自动解析代码库，生成架构图。
解决了传统手绘图更新不及时、Mermaid 组件多时混乱的问题。
通过调试 JSON 格式，实现了带标签的专业图表与肘形箭头。
架构图可作为代码文件进行版本控制，支持团队协作审查。
项目已开源，为开发者提供了新的文档自动化思路。
精华内容
告别繁琐的手动绘图，探索一种让架构图与代码同步进化的新方法。
传统绘图痛点
为项目制作和维护架构图是许多开发者的痛点。使用 Mermaid 画图，虽然代码生成方便，但当资源超过15个组件时，图表就会显得杂乱无章，难以阅读。而手动使用 Excalidraw 绘图，虽然视觉效果好，但每次基础设施变更都需要手动同步更新，这导致架构图几乎永远处于“过时”状态，无法真实反映系统现状。
Claude 技能方案
一个可行的方案是利用 Claude Code Skill。它并非复杂的脚本或服务器应用，而是一个 markdown 文件，通过该文件向 Claude 注入知识，教会它如何完成任务。这个技能可以分析 Terraform、Node.js 或 Python 等任意代码库，识别其中的组件、服务及相互关系，最终生成一个有效的 .excalidraw JSON 文件，实现架构图的自动化构建。
踩坑与优化
在实现过程中也遇到了一些挑战。最初生成的图表只有形状，没有文字标签，经过调试发现，Excalidraw 的 JSON 格式需要特定的“形状+文本”两元素模式才能正确显示。另一个问题是箭头样式，默认的斜线箭头在连接多个组件时显得不够专业，后来将其优化为 90 度的肘形箭头，绕着组件方框连接，视觉效果大为改善。
集成与协作
使用该技能非常简单，只需一句话指令即可完成。更重要的是，生成的架构图可以作为代码库中的文件（如 docs/architecture.excalidraw）进行版本控制。这意味着架构图的每一次变更都能在 Git 中追溯，团队可以在 Pull Request 中审查图表的改动，实现了像管理代码一样管理架构图，极大地提升了团队协作效率和文档的准确性。
这种自动化方案将架构文档从静态产物变为动态资产，极大提升了开发与协作效率。当架构图能自行迭代时，我们的工作流还能有哪些新的想象空间？
