Archify 是面向 AI 编程 Agent 的开源架构图技能：支持架构、工作流、时序、数据流、生命周期五类图，先生成类型化 JSON 源再经多重校验交付，交互全部基于已定义事实。产出自包含 HTML，可导出 PNG/视频/路径分享卡，兼容 Cursor、Claude Code、Codex CLI、OpenCode，MIT 开源。

Archify：把想法、代码和流程变成可交互的架构图

技能介绍

Archify 是一个面向 AI 编程 Agent 的开源技能（MIT 协议，73.9K Star）：你用一句话描述系统、流程或计划，它就生成一个自包含的交互式 HTML 图——节点可点击、路径可追踪、可导出 PNG/视频/分享卡，支持深浅主题。兼容 Cursor、Claude Code、Codex CLI、OpenCode 等支持 SKILL.md 的 Agent。

它的核心主张是"可验证"：不是随手画一张示意图，而是先生成带类型的 JSON 中间表示，经过 schema、布局、路由、标签间距等多重校验后才交付成品；交互（聚焦、上下游追溯、路径探测）全部基于你定义的事实，不虚构拓扑、不声称运行时影响。

适用场景

用 Claude Code / Codex CLI / OpenCode 等编程 Agent 的开发者
需要画架构图、流程图、时序图做技术沟通与评审的工程师
想把复杂系统讲清楚的 Tech Lead、方案讲解者与写作者

核心能力

五类图型，各管一种叙事：

↔ 左右滑动查看完整表格

类型	最适合	提示词里给什么
架构图	组件、服务、存储、边界	范围、核心组件、主路径
工作流	CI/CD、审批、工具调用	参与者、顺序、分支、异常
时序图	API 调用、缓存回退、异步链路	调用方、被调方、返回、时序
数据流	管道、血缘、敏感数据边界	来源、变换、存储、边界
生命周期	状态、重试、等待、终态	状态、事件、重试与取消路径

三种代表性交互（全部基于你定义的事实）：

工程化保障：类型化 JSON IR 可复现；交付前原子校验（schema/布局/HTML/SVG/路由/标签间距）；失败返回机器可读的修复清单（规则码+证据+受支持的修复项），而不是一堆 Node 堆栈；可选的本地预览循环只在候选通过全部校验后才刷新，坏文件不会覆盖上一次的好图。

架构变更对比：设计或 PR 评审时，可对已校验的 Before / Delta / After 快照做机器回执对比：

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

效果预览

工作流：跨泳道保持主路径清晰

时序：按时序讲清一次交互

数据流：让数据流动与敏感边界显式化

生命周期：区分推进、等待、重试与终态

工作方式

五步闭环：Agent 根据你的描述生成类型化 JSON IR → 内置校验器检查源文件，失败时给出精确的本地修复建议 → （可选）本地预览会话监视单个源文件、只加载验证通过的版本 → 同目录渲染候选成品并通过检查后原子替换目标文件 → 后续在对话中迭代，无关结构保持稳定。

常用命令：

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

不确定选哪种图？让零依赖 CLI 帮你判断：

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

你需要提供

一句话描述（不需要仓库），或一个让 Agent 阅读的真实代码仓库
图型选择与范围：核心组件、主路径、外部依赖、信任边界（拿不准可让 guide 子命令推荐）
迭代指令：加节点、移动位置、高亮路径、换主题等，Agent 基于类型化源做定向修改

你会获得

一个自包含 HTML 交互图：下载即用，无需安装 Archify，发给别人交互也跟着走
可复现的类型化 JSON 源文件，支持定向迭代与机器校验回执
PNG（复制/下载）、视频、路径分享卡（1200×630）等多种导出格式
稳定链接：#focus=、#route=~、#lens=~ 等可直接恢复到指定视图

使用示例

安装：

npx skills add tt-a1i/archify -g

描述即出图：

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

读仓库出带源码证据的架构图：

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.
Put supporting detail in cards instead of adding more edges.

继续对话迭代：add Redis、move auth to the left、highlight the rollback path、Switch to the light theme。

注意边界：自动解析 Mermaid、通用自动布局、托管分享、所见即所得编辑都不在当前范围内；它不是通用画图编辑器，而是把技术意图变成沟通成物的技能。查看器交互遵循系统"减少动态"设置，导出物不含临时查看器状态。