Archify：面向 AI Agent 的架构图管线，生成/渲染分离 + 五步门禁
Archify 是一个以 Skill 形式分发的 Node.js 架构图渲染与校验系统，面向 Cursor、Claude Code、Codex CLI 这类 Agent 环境。项目地址：
官方定位：
A Node.js architecture diagram rendering & validation system for AI agents like Cursor, Claude Code, Codex CLI.
它做的事情是画图、验证图、自检、导出。和常见的“AI 一键生成思维导图”类工具不同，Archify 把生成和渲染拆成两条独立的路径：模型只负责理解意图并产出结构化中间表示，渲染结果交给确定性编译器，避免“画错了重新生成碰运气”。
五类图：覆盖系统生命周期的主要视图
- ARCHITECTURE · 架构图：系统组件、外部依赖、存储、信任边界
- WORKFLOW · 工作流：登录、下单等业务步骤流，也覆盖 CI/CD、审批、运行手册
- SEQUENCE · 时序图：服务之间的调用时序，包括 API 调用、缓存回退、认证、异步追踪
- DATA FLOW · 数据流图：数据流转与落点，支持血缘、PII 标注、下游消费方
- LIFECYCLE · 生命周期：对象从生到灭的状态变迁，覆盖状态机、重试、等待、终态
五步管线：每一步都有校验门禁
核心逻辑是“约束生成”：不指望模型一次画对，而是让模型在严格护栏的管线里迭代。
- Generate 生成：Agent 根据描述或代码仓库生成类型化 JSON IR
- Validate 验证：内置校验器 + 布局规则检查，失败时返回机器可读 JSON，指明哪里要修
- Preview 预览（可选）：本地端口实时预览，只重载通过全部门禁的版本，不完整图不会闪现
- Deliver 交付：schema、布局、HTML/SVG、路由检查全部通过后，才原子性替换目标文件
- Iterate 迭代：对话中通过
add Redis、highlight the rollback path这类短指令继续精化
compare：架构快照 Diff
Archify 提供一个隐藏能力 compare：对比两个已校验的架构快照，输出 Before / Delta / After，精确列出新增、删除、变更、移动和改线的边。等于在合并代码前就可以审查架构变更，而不是等图画完再事后检查。
架构图的溯源价值
AI 编程产出的代码量大，但人对系统的理解速度往往跟不上。数据怎么流、流程哪里断，靠逐文件 review 很难快速定位。Archify 的使用方式是先生成时序图，再生成数据流图：
- 时序图告诉你“谁在什么时候调了谁”
- 数据流图告诉你“数据从哪来、经过什么加工、最后落到哪”
两张图对上，不读完整代码也能判断调用链是否正确。
另外，架构节点支持标注 SRC 证据锚点，直接链接到固定在某个 commit 上的源码文件和行号。每条边都可以溯源到真实代码。
需要说明边界：Archify 不是通用绘图编辑器，也不做自动 Mermaid 解析、通用自动布局、托管分享或所见即所得编辑。它的定位是把技术意图转化为沟通产物，拖拽式画 UI 原型不在范围内。
安装与使用
通用安装：
npx skills add tt-a1i/archify -g
Cursor 非交互式安装：
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
免安装试用：
npx skills use tt-a1i/archify@archify --agent codex
安装后的依赖目录：Claude Code 装到 ~/.claude/skills/，Codex 装到 ~/.agents/skills/。
不需要关联已有仓库，直接在对话里描述系统即可：
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
隐私方面：更新检查只 GET 一个固定的稳定清单用于显示可选提醒，不会自动下载安装更新。设置 ARCHIFY_UPDATE_CHECK_DISABLED=1 可彻底断网运行，企业内网可用。
产出物与项目状态
最终输出是自包含的单 HTML 文件（内嵌 SVG），打开即用。支持导出：
- PNG（可直接复制到剪贴板）
- 静态 / 动态 SVG
- WebM 视频
- 1200×630 分享卡片
项目以 MIT 协议开源，214+ commits，CI 覆盖 Node 18–24 测试矩阵，治理文档齐全。
要在项目里实际用起来，路径比较直接：装上，喂一个熟悉的项目，先生成时序图再生成数据流图，对着图找代码问题。