Archify 是一个开源的 AI Agent 技能,支持 Claude Code、Codex、Cursor 等主流编码助手,能将自然语言描述的想法、计划或代码库自动转化为基于 Mermaid 的交互式 HTML 架构图。项目拥有 9.7 万星标、13 万次安装,采用 Apache 2.0 协议,致力于降低系统设计可视化门槛,让开发者与非技术人员都能快速产出可探索、可分享的架构文档。
适用人群:后端与全栈工程师:需要快速输出系统设计文档、序列图、部署拓扑图的开发者;技术负责人与架构师:在方案评审、技术分享、团队协作中需要可视化沟通工具的决策者;产品经理与技术文档撰写者:希望将需求、流程、业务逻辑转化为交互式图表以便跨团队对齐的非代码角色。
适用场景:新项目启动阶段:用自然语言描述业务流程,让 AI 生成序列图与组件图,快速完成初版架构设计;遗留代码库梳理:将现有代码结构喂给 Agent,自动反向生成模块依赖图与调用链路图,辅助重构决策;技术方案评审与分享:会议中实时生成交互式图表,支持缩放、点击节点查看细节,替代静态 PPT 截图。
推荐理由:Archify 将 LLM 的语义理解与 Mermaid 的声明式绘图完美结合,零配置即可在主流 AI 编码助手中直接使用,输出可离线分享的单文件 HTML,极大降低了架构可视化的认知与工程成本,是当前 AI 原生开发工作流中最实用的图表生成工具之一。
项目定位与背景
随着 LLM 在编码领域的深度渗透,开发者越来越习惯用自然语言描述意图,再由 AI 生成代码或文档。但架构设计与系统可视化长期依赖手绘或专业建模工具,门槛高、迭代慢、难以版本控制。Archify 正是针对这一痛点诞生的开源项目,定位为 AI Agent 的一个可复用技能,主打将任意文本意图转化为交互式 Mermaid 图表,并封装为单一 HTML 文件,开箱即用、无需部署。项目由 tt-a1i 团队维护,官网 archify.si 提供在线画廊与场景指南,已在 skills.sh 平台累计安装 13 万次,GitHub 星标近 10 万,足见社区认可度。
核心功能与技术架构
Archify 的核心流程分三步:用户在支持的 AI 客户端中调用 archify 技能,描述想法或粘贴代码;Agent 解析意图,生成符合 Mermaid 语法的图表定义;最后由 Archify 运行时将定义渲染为自包含的交互式 HTML,内置缩放、平移、节点高亮、主题切换等交互能力。技术栈以 JavaScript 为主,依赖 Mermaid.js 做渲染引擎,输出文件零依赖、可直接在浏览器打开或嵌入 Notion、Confluence 等平台。支持的图表类型涵盖流程图、序列图、类图、状态图、C4 架构图、甘特图等主流软件工程场景。作为 Agent 技能,它遵循统一的技能协议,可在 Claude Code、Codex、Cursor、OpenCode 等主流客户端间无缝迁移,配置仅需在技能清单中添加 archify 即可。
创新点与亮点
首先是交互式 HTML 的单文件分发模式,彻底解决了图表分享时的环境依赖问题,接收方无需安装任何工具即可在浏览器中探索细节。其次是深度融合 LLM 的语义建模能力,用户无需掌握 Mermaid 语法,只需用自然语言描述业务流程、模块关系或部署拓扑,Agent 即可自动完成语法生成与布局优化。再次是场景化的提示词工程与模板库,官方提供旅行规划、学习地图、微服务架构、CI/CD 流水线等十余个开箱即用的场景示例,显著降低冷启动成本。最后是开放的技能生态定位,Archify 不绑定特定 AI 平台,而是作为通用技能接入多个主流编码助手,体现了工具链中立的开放理念。
与同类项目对比
对比传统建模工具如 PlantUML、Draw.io、Lucidchart,Archify 的优势在于 AI 原生交互、零学习成本、版本控制友好、输出可直接嵌入文档站点;劣势在于复杂大型图表的精细布局控制不如专业工具灵活,且依赖 LLM 的生成质量,极端边缘场景可能出现语法错误。对比同类 AI 图表生成项目如 Mermaid Chart、DiagramGPT、Eraser.io,Archify 的差异化在于技能化封装与多客户端互操作,以及对交互式 HTML 单文件输出的坚持,更适合开发者在本地 IDE 工作流中闭环使用,而非仅作为在线演示工具。
上手指南与快速开始
以 Claude Code 为例:在项目根目录创建 .claude/skills/archify.json,内容为 {"name": "archify", "version": "latest"};重启 Claude Code 后即可在对话中输入 "/skill archify 画一个用户登录的序列图" 触发生成。生成的 HTML 文件默认输出到工作目录下的 archify-output 文件夹,可直接双击打开。Cursor 用户可在设置中启用 Archify 插件,Codex 用户需在技能市场安装。官网 guide 页面提供了从基础语法到高级主题定制的完整教程,建议新手先浏览画廊了解效果边界,再结合场景指南逐步深入。
总结与展望
Archify 以极简的技能封装、强大的 AI 语义建模、通用的交互式 HTML 输出,成功将架构可视化纳入 AI 原生开发工作流的标准动作。当前版本 3.2.0 已在稳定性与模板丰富度上达到生产可用水准。展望未来,期待看到更多针对大型代码库的增量反向工程能力、团队协作下的图表版本管理集成、以及与架构决策记录工具的深度联动。对于追求文档即代码、设计即对话的现代工程团队,Archify 是值得纳入工具箱的高杠杆工具。
项目信息
| 项目名称 | tt-a1i/archify |
| 编程语言 | JavaScript |
| Star 数 | 97815 |
| Fork 数 | 6680 |
| 主题标签 | agent-skills, ai-agents, architecture-diagram, claude-code, claude-skills, codex, coding-agents, deepseek-harness, developer-tools, diagrams, diagrams-as-code, dsh-plugin, flowchart, llm, mermaid, opencode, sequence-diagram, software-architecture, system-design, visualization |