# Archify：给 AI Agent 用的架构图生成器

---

**Archify** 是一个 Agent Skill——把代码库或系统描述变成可验证的交互式架构图。支持五种图型：架构图、工作流、时序图、数据流、生命周期图。

核心思路：**Agent 产出类型化的 JSON IR，Archify 确定性编译成 HTML/SVG**。Agent 负责画什么，机器负责验证画得对不对。

---

## 一、Agent 画图，机器验证

Archify 的流水线：

```text
Generate  Agent 从描述生成类型化 JSON IR
Validate  校验器和布局规则检查源文件
Preview   桌面循环监视 JSON，只加载通过验证的修订
Deliver   渲染 + 检查，通过才原子替换目标文件
Iterate   Agent 更新源文件，无关结构保持稳定
```

关键在于 **原子验证**：schema、布局、HTML/SVG、路由、标签到路由的间隙检查**全部通过**，新图才会替换上一张好图。失败的保存不会破坏现有产物。

---

## 二、失败带修复单

AI 生成内容的常见问题：错了，但你不知道为什么错、怎么修。Archify 的验证失败输出是机器可读的修复单：

```bash
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
```

返回的是稳定规则码、精确的问题主体、实测证据、受支持的修复操作——不是 Node 堆栈或一句模糊的「重试」。

Agent 拿到修复单，按支持的修复操作改源文件，两轮内收敛。这是「AI 生成 + 机器验收」的闭环。

---

## 三、架构图评审：Before / Delta / After

PR 评审场景：改了架构，怎么对比改了什么？

```bash
node bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json
```

Architecture Delta 对比两张验证过的快照，机器出收据：精确列出**新增、删除、修改、移动、改道**的每一条事实。播放差异或逐条审查，不推断影响、不推断风险、不推断合并安全性——只陈述事实。

---

## 四、交互保真：不发明拓扑

图打开以后的一切交互都复用**已声明的节点和关系**：

- 聚焦语义节点（`/` 搜索）
- 追踪上游/下游的声明可达范围
- 探测两点间的精确路由（`R`）
- 对比两个语义角色的真实流量（`L`）
- 播放有作者的引导故事（`P`）

可选做「源码证据」：节点标记 `SRC n`，打开 Git 校验过的文件和行号范围，锁定在某个公开 commit。普通图保持无源码，证据模式只在要求时开启。

---

## 五、五种图型怎么选

| 图型 | 适合 |
|------|------|
| Architecture | 组件、服务、存储、边界 |
| Workflow | CI/CD、审批、工具调用、runbook |
| Sequence | API 调用、缓存回退、认证、异步追踪 |
| Data Flow | 管线、血缘、PII、消费者 |
| Lifecycle | 状态、重试、等待、终态 |

不确定用哪种？零依赖 CLI 帮你选：

```bash
node bin/archify.mjs guide "Show an API request with Redis cache miss"
```

---

## 六、导出

单文件 HTML 是主交付物。导出菜单覆盖：PNG 复制到剪贴板、静态/动态格式下载、**1200×630 分享卡**（README、release、社交发帖）、路由分享卡（保留全图作上下文）。

---

## 七、安装

```bash
npx skills add tt-a1i/archify -g
```

支持 Cursor、Claude Code、Codex CLI、OpenCode、Raven、Claude.ai。不需要仓库——聊天里直接描述系统就能画：

```text
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
```

---

## 结语

Archify 的定位清晰：架构图是技术沟通的产物，不是随手画的涂鸦。它把「画图」从审美问题变成工程问题——类型化源文件、确定性编译、原子验证、修复单、差异收据。Agent 负责表达意图，机器保证产物可信。


Archify 是一个 Agent Skill——把代码库或系统描述变成可验证的交互式架构图。支持五种图型：架构图、工作流、时序图、数据流、生命周期图。

Archify：给 AI Agent 用的架构图生成器

软件研发

开发工具

架构设计

人工智能

Archify为AI Agent提供架构图生成功能，将代码库转化为可验证的交互式图表。支持架构、工作流、时序、数据流和生命周期五种图型，通过类型化JSONIR实现确定性编译。采用原子验证机制，输出机器可读修复单，支持Before-Delta-After评审对比，确保AI生成内容的高质量和可靠性。

代码解释

数据流

路由

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Archify：给 AI Agent 用的架构图生成器-腾讯云开发者社区-腾讯云

Archify：给 AI Agent 用的架构图生成器

Archify：给 AI Agent 用的架构图生成器

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐