画微服务架构图不用拖组件了：Archify用一句话生成架构图流程图时序图，JSON IR加Schema校验保证不翻车
做开发和架构设计的人一定有这样的体会：写技术方案、架构文档、README，最费时间的不是理清逻辑，而是画图。Draw.io、Visio 需要手动拖拽组件、连线、调整布局、修改颜色，一张复杂的微服务架构图要十几分钟；Mermaid、PlantUML 要熟悉很多语法，多分支流程、复杂云架构很容易出错。
Archify 就是用来解决这个问题的。一句话概括：它就是用大白话来生成专业架构图的 Skill。在 GitHub 上已经有 5700 个 Star。
实际使用体验
比如想给自己的微服务项目画一张架构图，打开 Claude Code，说一句"画一个电商系统的架构，包含前端、API 网关、订单服务、支付服务、数据库、缓存"，它就开始生成图表。
Claude 先生成一个结构化的 JSON 描述，包括组件、连接和坐标等信息，然后自动生成 HTML——打开目录后看到的是一个单独的 HTML 文件，可以直接在浏览器中打开。
图表有深色和浅色两种主题，按 T 键可以一键切换。按 E 键弹出导出菜单，可以将 PNG 格式图片复制到剪贴板，也可以选择下载为 PNG、JPEG、WebP、SVG 等格式。整个过程只说了一句话，后面生成 JSON、渲染图表、切换主题、导出图片等工作都是它自己完成的。
核心功能
五种图表类型。 Archify 一共支持五种常见的技术图表：Architecture（系统架构图）、Workflow（泳道流程图）、Sequence（时序图）、Data Flow（数据流图）、Lifecycle（状态机图）。这五种类型涵盖了开发者在技术文档、方案设计、架构评审、CI/CD 文档、API 文档等场景下的绝大多数绘图需求。每种图表都有自己的 JSON Schema 和渲染器，保证输出的稳定性与可复现性。
自然语言驱动，零学习成本。 只需要用大白话描述系统或流程，比如画出一个 CI/CD 流程：pull request -> tests -> approval -> build image -> staging -> smoke test -> production。Archify 可以生成相应图表，不需要学习 Mermaid 语法，不需要拖拽组件，不需要调整布局。
双主题自适应切换。 每一个生成的图表都有深色和浅色两种主题，可以通过按钮或快捷键 T 切换。导出的 SVG 文件里有双主题 CSS 变量集以及 prefers-color-scheme 媒体查询，当它被嵌入到 GitHub 的 README 或博客中时，可以自动跟随读者的系统主题。这意味着只需要维护一个 SVG 文件就可以同时适配深色和浅色两种阅读环境。
最高 4 倍高清导出。 所有的栅格导出（PNG、JPEG、WebP）都是以最高的安全分辨率来渲染，最高可以达到 4 倍，不会出现模糊或锯齿。并且可以一键将 PNG 复制到剪贴板，直接粘贴到 Slack、Notion、GitHub、Figma 等工具里。
JSON IR + Schema 验证闭环。 Archify 并不是简单的 AI 生成器，而是一个有完整工程化闭环的工具。每种图表类型都对应着一个 JSON IR 和一个 JSON Schema，Claude 先生成结构化的 JSON，然后由渲染器生成 HTML/SVG。渲染器在生成之前会做 Schema 校验、布局检查、HTML/SVG 完整性检查，防止生成畸形图表。
安装方式
Archify 安装只需要一条命令：
npx skills add tt-a1i/archify -g
这个命令会通过开源的 skills CLI 安装 Archify，支持 Claude Code、Codex CLI、opencode 等多种 AI Agent 平台。
安装好之后，在 Claude Code 中说"使用 archify 来绘制出该仓库的运行时架构图"就可以画出结构图了。
如果只是试用，不需要永久安装，可以使用：
npx skills use tt-a1i/archify@archify --agent codex
将 codex 替换为 claude-code 或 opencode 就可以适配不同的 Agent。
局限性
Archify 并不是通用的绘图编辑器，不能像 Figma、Visio、Draw.io 一样自由拖拽编辑。它要做的是把自然语言转换成成品图表，如果要修改图表，只能通过对话或编辑 JSON IR 来实现，不能直接在画布上拖动。
另外，在导出为 PNG、JPEG、WebP 格式时会先使用系统自带的等宽字体，只有在本地安装了 JetBrains Mono 之后才能用。Archify 没有使用自动布局，而是让 AI 自己来判断布局。
项目基于 MIT 协议开放。
开源地址：https://github.com/tt-a1i/archify