Archify Skill：让 AI 图表从「画框图」进化为「可验证的系统地图”

Skill超级捕获手 技术创作者 2026-09-04 11 阅读

Archify 是一个面向 AI 编程 Agent（Cursor / Claude Code / Codex CLI / OpenCode）的架构图表渲染与验证系统。Agent 用自然语言描述系统拓扑，Archify 将其编译为类型化 JSON IR，再确定性输出自包含 HTML/SVG 交互图表。它火在三点：把 AI 生成图表从「随意画框图」提升到「可验证、可对比、可追踪」的专业级别；覆盖架构、工作流、时序、数据流、生命周期 5 类图；输出的 HTML 零依赖、可分享、带动效，无需任何构建步骤。GitHub 9 月新晋 trending，不到一周 33k+ stars 增长，当前共 47k+ stars（截至 2026-09-04）。

功能与原则

Archify 核心是一个 JSON IR → HTML/SVG 的确定性编译器，而非 AI 随机生成。流程为：Agent 读取代码库 → 生成结构化 JSON 描述拓扑 → Archify 验证节点、边界、层级 → 输出 HTML。它遵循三条设计原则：类型安全（JSON IR 有严格 schema，验证不合法拓扑直接拒绝）、确定性渲染（同一 JSON 必出同一图，无随机偏移）、零依赖交付（输出为单 HTML 文件，浏览器即开，无需服务器或 CDN）。

认可度

GitHub Stars 47,176（截至 2026-09-04），Forks 3,045。9 月第一周即进入 GitHub Trending 日榜，9 月 1 日当天新增约 3,991 stars，CSDN / Git Trending Rank 等中文技术社区同步报道。Skilld.dev 将其列入「Trending agent skills, September 2026」推荐位，社群讨论热度高。

链接

GitHub：https://github.com/tt-a1i/archify

原作者

GitHub 用户 tt-a1i（真实姓名未公开），独立开发者，Archify 为其主要作品。官方文档完整，配有 Scenario Guide / Proof Lab 等丰富示例站（tt-a1i.github.io/archify）。

介绍

Archify 的核心价值在于解决 AI 生成图表「看起来对但不可信」的问题。当 AI Agent 画出一个微服务架构图，工程师无法验证图中连接是否真实存在于代码中、边界划分是否有依据。Archify 要求 Agent 生成结构化 JSON IR，其中每个节点、每条边都带语义标签，验证层检查节点是否越界、路径是否闭环，验证通过后才渲染图表。验证收据（receipt）与图表一起保存，后续可对比两次快照的差异。

渲染输出支持 5 类图：架构图（组件、服务、数据库、边界）、工作流（CI/CD、审批、异常处理）、时序图（API 调用链、认证流程、缓存回退）、数据流图（ETL 管道、PII 边界、数据血缘）、生命周期图（状态机、重试、超时）。每类图均支持暗/亮主题、搜索节点、上下游可达性追踪、路由探测、引导式故事播放。

导出版本包括 PNG、SVG、WebM 动画和 1200×630 社交分享卡。特别实用的是架构 Delta 对比功能：两次快照可并排显示 Before / Delta / After，精确标注新增、删除、迁移、重路由的节点，适合 PR 审查场景。

特点

  • JSON IR 验证层：不是直接渲染 AI 输出，而是要求 Agent 吐结构化 JSON，验证通过再画图，拒绝不合法的拓扑
  • 确定性渲染：同一 JSON 输入必出同一 SVG 输出，告别 AI 每次生成位置不同的问题
  • 5 类专业图表：架构 / 工作流 / 时序 / 数据流 / 生命周期，覆盖系统设计全场景
  • 自包含 HTML：零依赖、零服务器，邮件发给同事、丢进 PR 评论、附在文档里均可
  • 架构 Delta 对比：快照 Diff，Before / Delta / After 三视图，精确追踪架构演进
  • 交互式导航：搜索节点、追踪上下游可达路径、播放引导式架构讲解
  • 多 Agent 支持：Cursor / Claude Code / Codex CLI / OpenCode 均可用，DeepSeek Harness 也有集成

使用方法

安装（一键全局）：

npx skills add tt-a1i/archify -g

Cursor 专用安装：

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

免安装试用（Codex）：

npx skills use tt-a1i/archify@archify --agent codex

基础调用示例：

在 Agent 对话中直接描述需求，例如：

Analyze this repository, then use archify to create a high-level runtime architecture diagram. Show 8–12 core components, one primary path, external dependencies, and trust boundaries.

Agent 会生成一个 architecture.json（JSON IR），Archify 验证后输出自包含 HTML 文件，浏览器自动打开，支持导出 PNG / SVG / WebM。

聚焦细化（后续对话）：

Add Redis as a cache layer between API and PostgreSQL.
Move the auth service to the left boundary.
Highlight the rollback path in red.

Archify 在已有 JSON IR 上迭代，保持类型安全。

使用场景与人群

适用场景： 系统设计文档编写、PR 架构审查、团队架构对齐、技术方案分享。目标用户： 后端/架构工程师、全栈开发者、技术 Lead，尤其适合在 AI Agent 辅助下做设计的团队——让 AI 生成图表这件事变得可信、可复用、可版本控制。

输入与输出案例

案例 1 — 架构图生成

输入（在 Claude Code 中）：

Analyze this repo and draw the runtime architecture. Show the API gateway, auth service, user service, Redis cache, and PostgreSQL. Mark the trust boundary between the public internet and internal services.

输出：一个自包含 HTML 文件，节点包括 API Gateway / Auth Service / User Service / Redis / PostgreSQL，边界线标注 trust boundary，支持节点搜索和上下游追踪，可导出 PNG 分享。

案例 2 — PR 架构变更对比

输入：仓库经过一轮重构后，在 Agent 中运行：

Trace the current architecture and save a snapshot. [完成重构后] Trace again and compare with the previous snapshot.

输出：Before / Delta / After 三视图，精确显示新增了消息队列、移除了直接 DB 调用、改变了缓存策略，并附验证收据。

GitHub: https://github.com/tt-a1i/archify

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读