代码库看不懂？给 Agent 装个能生成可交互架构图的 Skill

小七最近发现一个有意思的 Skill——Archify。它能让 Coding Agent 把一个想法、一套工作流程，甚至整个代码库，转化为可交互、可分享的 HTML 可视化作品。

这次我们在 Codex 中安装 Archify，并用一个真实的开源项目测试它的代码架构梳理能力，看看最终能交付什么成果。

先选一个真实代码库

这次我们选用开源项目 Graphify 作为测试对象。它能将代码和项目资料整理成可查询的知识图谱，涉及本地代码结构提取、语义信息处理、图谱构建和查询等环节。项目包含多个处理模块和不同的执行路径，适合用来检验 Archify 对真实代码库的架构梳理与可视化能力。

首先，让 Codex 从 GitHub 获取 Archify，并安装到全局 Skill 目录：

帮我安装这个 Skill
安装到 Codex 全局环境，安装完成后告诉我结果。

图 1：Codex 安装 Archify。

整个安装过程耗时 1 分 29 秒，Codex 成功安装 Archify v3.2.0 稳定版，并通过 doctor 检查。

安装完成后，我们直接在 Codex 对话中输入 /archify，让 Agent 开始执行架构可视化任务：

/archify 请使用已经安装的 Archify Skill，阅读当前工作区 Graphify 文件夹中的代码，为开发者制作一份项目架构可视化成果，让他们能够快速理解项目的核心模块、模块之间的关系和主要运行流程。

你自行判断最合适的呈现方式，直接完成并将最终文件保存在 Graphify/deliverables 文件夹中。

不要修改项目源代码，也不要读取或参考 261105_Archify-Baseline 文件夹中的第一次实测成果。

我们没有预设分析步骤和图表布局，把具体的架构梳理交给 Archify 自行处理。5 分 09 秒后，Codex 完成任务，交付了 graphify-architecture.html 和 graphify-architecture.delivery.json（Archify 交付凭据）。

图 2：Graphify 核心架构图

打开 HTML，能看到完整的 Graphify 架构地图。整张图包含 10 个节点，覆盖建图入口、语料扫描、本地结构抽取、语义抽取、合并与建图、社区分析、代码图更新、落盘与导出、本地图谱以及 CLI/MCP 检索等关键环节。模块之间通过连线组织起来，可以从整体上了解 Graphify 如何完成建图，以及后续如何查询图谱。

拿到架构图之后怎么用？

点击节点：直接定位模块源码

图 3：本地结构抽取节点的源码定位与证据查看

点击「本地结构抽取」节点，左侧会显示对应的源码证据面板，列出仓库、Commit、源码文件和具体行号。例如，该节点关联到 graphify/extract.py，点击源码引用即可跳转到 GitHub 对应 Commit 的代码位置。

本次生成的 HTML 共包含 30 条源码引用，开发者可以从架构图中的模块直接定位到具体实现。

路径追踪：查看模块之间的执行路径

图 4：从建图入口到 CLI 与 MCP 检索的路径追踪

这次我们选择「建图入口」和「CLI 与 MCP 检索」作为起点和终点。Archify 会高亮两者之间的连接路径，并弱化其他节点和连线。沿着这条路径，可以直观看到建图入口、各处理模块与查询接口之间的关系，帮助开发者梳理项目的主要处理流程。

语义透镜：按类别筛选架构模块

图 5：选择处理模块和本地文件后的语义透镜效果

Archify 的语义透镜支持按语义角色聚焦和对比架构图中的节点。这次我们选择「处理模块」和「本地文件」两个角色，分别突出显示其中的 7 个处理模块和 1 个本地文件，其余节点则相应弱化。通过切换对比角色，可以从不同职责维度观察同一张架构图。

图片导出：将架构图用于技术文档

[图 6：实际导出的 PNG 架构图]

Archify 支持将架构图导出为图片等格式。这次我们导出了 PNG 图片，完整保留了节点、连线和图例，可直接用于项目介绍、技术文档和团队交流。交互式 HTML 则可以通过浏览器打开和分享，保留原有的交互探索能力。

源码依据也经过了实际核验

交付前，我们检查了 Git 工作区，确认 Graphify 原有源代码未被修改。同时，抽查了架构图中 3 条来自不同模块的源码引用，文件路径、代码行号及对应逻辑均通过核验。

和直接使用 Codex 有什么区别？

安装 Archify 之前，我们先让 Codex 独立完成了一次 Graphify 架构可视化任务。11 分 11 秒后，它交付了一份交互式 HTML，包含 10 个架构节点、3 条主要流程和 24 个本地源码链接。

安装 Archify 后，第二次交付的成果包含 30 条源码引用，并支持节点源码定位、路径追踪、语义透镜和图片导出。

需要说明的是，两轮任务的 Prompt 和执行流程并不完全相同，且源码链接与源码引用的统计口径不同，因此不能直接据此判断效率或数量上的提升。这里主要对比两次交付成果的功能差异，耗时仅作为本次实测记录。

从交付能力来看，Codex 原本就能生成架构图，Archify 则进一步提供了源码证据关联、路径追踪、角色对比和图片导出，让架构图成为一份可以继续探索和使用的成果。

不只是生成一张架构图

代码架构只是 Archify 支持的应用场景之一。官方提供了 10 种图表类型，覆盖不同的信息表达需求：

• 结构关系：Architecture、Class、ERD、Tree
• 执行过程：Workflow、Sequence、Data Flow
• 状态与时间：Lifecycle、Timeline、Waterfall

此外，Archify 还支持生成一页式解释页面，可以将结论、文字、表格、步骤和图表组合在一起。

因此，它的应用范围并不局限于代码架构。系统设计、API 调用、业务流程和数据关系，也可以尝试用 Archify 整理成相应的可视化成果。

本次实测主要验证了 Architecture 架构图，其他图表类型和一页式解释页面暂未逐一测试。