Archify Skill：让 AI 直接在对话里生成可交互的架构图

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

Archify Skill：让 AI 直接在对话里生成可交互的架构图

Archify 是一个专门为 AI 编码助手打造的架构图生成 Skill，能够把自然语言系统描述或代码库结构，直接在对话窗口内编译成一份可交互、可验证的单文件 HTML 架构图。它解决了 AI 编程助手”能写代码但画不出图”的短板——不是又一个 Mermaid 渲染工具，而是一套”AI 生成 → 类型化校验 → 确定性渲染”的完整闭环。本周（2026-09-01）以 +3,722 Stars 的单日增量空降 GitHub Trending 榜首，累计约 38,600 Stars，成为当前 AI Agent 工具链里增长最猛的独立 Skill 之一。

功能与原则

Archify 的核心功能是将 AI Agent 对代码库或系统架构的理解，转化为五种结构化图表：架构图（Architecture）、工作流图（Workflow）、时序图（Sequence）、数据流图（Data Flow）和生命周期图（Lifecycle）。每种图表类型对应特定场景，有对应的 prompt 示例，不需要用户手写任何图形代码。

设计原则是”确定性编译”而非”拖拽式绘图”。AI Agent 输出的是类型化 JSON 中间表示（JSON IR），而非直接生成 SVG。Archify 的校验层对节点、边界、连接关系做 schema 检查，通过后才交由渲染器生成 HTML/SVG。这意味着产出的每一条线、每一个节点都有迹可循，不会出现 AI 随意发挥导致图形错乱的问题。

认可度

  • GitHub Stars：约 38,600（截至 2026-09-01，whatstrending.ai 快照数据）
  • 今日新增：+3,722（2026-09-01 GitHub Trending 全部类目 #1）
  • Fork：约 3,991
  • License：MIT
  • 当前稳定版：v2.16.0（2026-08-30）
  • 创建时间：2026-04-15
  • 近期爆发轨迹： 2026-08-26 约 16,783 Stars → 08-31 约 34,456 Stars → 09-01 约 38,598 Stars，6 天翻倍
  • 支持智能体： Claude Code、Cursor、Codex CLI、OpenCode；DSH 社区插件（dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0）

链接

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

原作者

作者 GitHub 账号为 tt-a1i，项目页面为 tt-a1i.github.io/archify。tt-a1i 同时维护了 agents-market-installer（多 Agent 安装器 Skill）等多个 AI 工具类项目，已形成小型工具矩阵。

介绍

传统的 AI 架构图生成方案，本质上都是”让 AI 写 Mermaid 代码然后渲染”，但 Mermaid 语法对 AI 来说容易产生语法错误、布局混乱、箭头乱连的问题，且无法在图表生成后做增量对比。Archify 的做法则完全不同：Agent 根据用户描述（自然语言或粘贴的 Mermaid 代码）生成 JSON IR，Archify 对这份 JSON 做类型校验和布局检查，然后确定性渲染为 HTML/SVG。每一条连接线都来自 JSON 中的显式声明，而非渲染器猜测——这从根本上避免了 AI 幻觉式图形的问题。

生成的 HTML 是零依赖的单文件，包含内联 CSS 和 SVG，浏览器打开即可看，无需任何服务器或框架。交互功能相当丰富：节点搜索、上下游依赖追踪（Upstream/Downstream Reach）、路径探查（Route Probe）、按语义角色比较流量差异、引导式演示模式（Presentation Stage）等，都能在一个 HTML 文件里完成。

在 Pull Request 场景下，Archify 最有价值的功能是”架构快照对比”：两次生成的 JSON IR 可以做 diff，展示 Before / Delta / After 三个状态——精确标注新增、删除、迁移或重新路由的组件和连接关系，配合验证回执（validation receipt），让架构变更 review 像代码 diff 一样可审计。

特点

  • 类型化 JSON IR：AI Agent 生成结构化 JSON 而非直接输出图形，消除语法错误和随机布局
  • 五类图表覆盖：Architecture / Workflow / Sequence / Data Flow / Lifecycle，各有专门布局算法和交互模式
  • 确定性渲染：校验（schema + 布局 + HTML + SVG）四层检查，不合格不输出
  • PR 架构 Diff：Before / Delta / After 三态快照对比，适合架构变更 review
  • 丰富交互：节点搜索、路径追踪、上下游 Reach、语义角色流量对比、引导演示模式
  • 暗色/亮色主题一键切换：T 快捷键切换，E 导出 PNG / JPEG / WebP / SVG / WebM
  • 单文件 HTML 输出：零依赖、跨平台、可直接嵌入 Notion / Slack / GitHub 评论 / PPT
  • 1200×630 分享卡片：内置社交媒体封面图生成器，适合 README / Release 通知 / 社交发帖
  • 安装极简：npx skills add tt-a1i/archify -g，无需克隆仓库

使用方法

安装（全球适用）：

npx skills add tt-a1i/archify -g

直接用自然语言在 Agent 对话里触发：

Use archify to draw an architecture diagram: React frontend calls a Node.js API backed by PostgreSQL and Redis, deployed on AWS behind CloudFront, highlight security boundaries.

支持粘贴 Mermaid 代码（flowchart / sequenceDiagram / stateDiagram），Archify 会用自身的布局算法重新渲染，而不是直接显示 Mermaid 原生图形。

典型使用场景示例：

CI/CD 工作流

Use archify to draw a CI/CD workflow: pull request → tests → approval gate → build image → staging deploy → smoke test → production deploy, with rollback on failure.

数据管道

Use archify to draw a data flow: Kafka → Flink processing → Iceberg table → Presto query layer → Dashboard, highlight PII boundary.

使用场景与人群

适用场景：

  • 新项目启动时，用自然语言快速生成架构草图用于团队对齐
  • 接手遗留代码库，用 Archify 生成架构图加速理解
  • PR Review 时，对比新旧架构快照，量化接口和依赖变更
  • 技术文档 / README / 提案中嵌入可交互的架构图（而非静态图片）
  • 架构设计讨论时，在对话窗口内实时生成图示，无需切换工具

目标用户：

  • AI Coding Agent 重度用户（Claude Code / Cursor / Codex / OpenCode）
  • 需要频繁绘制架构图的技术 lead、架构师
  • 团队需要对代码架构变更做可量化 review 的开发者
  • 希望把架构可视化嵌入文档和发布流程的 DevOps / 技术 writer

输入与输出案例

案例 1：微服务系统架构描述

Input（自然语言）：

Use archify to draw: Browser → CloudFront CDN → Load Balancer → 3x Node.js Microservices (Auth, Billing, Orders) → PostgreSQL (multi-AZ) + Redis (cache) → SQS queue for async order processing

Output：一份架构图 HTML，包含 Browser → CDN → LB → 三个微服务节点，连接到数据库和消息队列，所有连接带方向箭头。点击节点可查看上下游 Reach，可切换暗色/亮色主题，导出 PNG。

案例 2：PR 架构变更对比

变更前 JSON IR → 变更后 JSON IR → Archify Diff：

Before: Auth Service → JWT Token Store (Redis)
Delta: [- Redis] [+ Postgres] (JWT validation moved to DB)
After: Auth Service → PostgreSQL (JWT)

精确列出：Redis 连接删除，PostgreSQL 连接新增，无其他改动，配合验证回执确认所有受影响路径。

Archify 是当前 AI Agent 工具链里增速最快的独立 Skill 之一，MIT 协议，零锁定，值得作为 AI Coding 工作流的标准装备纳入工具箱。

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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 236 阅读