Archify 是把代码库或系统描述一键转成可交互系统地图的 Node.js 渲染 + 校验技能，支持 Cursor、Claude Code、Codex CLI、OpenCode 五类图、四种预设、深浅主题和架构变更 Before/Delta/After 对比，适合架构师、技术评审和写技术文档时快速产出可分享、可审阅的架构图。
Archify 是一个为编码 Agent 设计的架构图与系统地图生成技能。它让 Cursor、Claude Code、Codex CLI、OpenCode 等 Agent 把一段系统描述或一个代码库，编译成可交互、可分享、自带校验的 HTML/SVG。核心价值是"布局判断 + 原子校验 + 真相交互"：Agent 负责写出带类型 JSON IR（中间表示），Archify 用确定性渲染器把它变成五种图（架构、工作流、时序、数据流、生命周期），并通过 schema/layout/HTML/路由/标签多层校验后才替换上一份图，避免"失败被假装成功"。
Mermaid 是通用画图语法，draw.io 是手画工具；Archify 不做"通用画图"，它做"技术意图 → 沟通成品"。区别有三：(1) Agent 写的是带类型 JSON，校验器能精确指出哪个节点/路径坏了；(2) 渲染是确定性的，同一个 IR 永远出同一张图，便于评审和回归；(3) 交互是"对真实内容的"——节点可聚焦、可追上游/下游、可走命名路由，但绝不臆造拓扑或假装有运行时影响。架构图也支持 Before/Delta/After 三联对比，把 PR 改了什么一图说清。
无需仓库：在 Chat 里直接说"用 Archify 画：浏览器 → API → Redis 缓存 → PostgreSQL 兜底"。要源码证据就打开仓库，要求"分析这个仓库再用 archify 出高层运行时架构图，8~12 个核心组件、一条主路径、外部依赖和信任边界"。生成后用 `add Redis`、`move auth to the left` 这类局部指令迭代。它支持 `npx skills add tt-a1i/archify -g` 安装，也支持 Cursor、Codex、OpenCode、Claude Code 等 4 类切换器和 Raven ZIP 手动安装。
它强调"布局判断"而不是"通用自动布局"：Agent 自己决定层级、间距、路由和重点；共享自动端点会确定性分散而不是所有箭头堆一个中点。每张"展示级"图都要通过 schema/layout/HTML/路由/标签-路由净空五道关，任意一道挂了，校验器给出机读 receipt 告诉 Agent 改哪个节点——不是栈追踪也不是模糊重试。桌面预览还有"上一份成功图保留"的兜底：保存失败不替换，避免半成品覆盖已发布的图。
架构师、技术评审者、写技术文档/分享稿的人、要做"PR 改了什么"可视化对比的工程团队，以及任何想让 AI Agent 画出来的图"经得起别人检查"的人。它不适合画风格自由插画、不试图取代 Mermaid 的随手语法，也不是 WYSIWYG 编辑器——它的强项是"严谨的可分享架构图"。
Mermaid 是通用画图语法，draw.io 是手画工具；Archify 不做"通用画图"，它做"技术意图 → 沟通成品"。区别有三：(1) Agent 写的是带类型 JSON，校验器能精确指出哪个节点/路径坏了；(2) 渲染是确定性的，同一个 IR 永远出同一张图，便于评审和回归；(3) 交互是"对真实内容的"——节点可聚焦、可追上游/下游、可走命名路由，但绝不臆造拓扑或假装有运行时影响。架构图也支持 Before/Delta/After 三联对比，把 PR 改了什么一图说清。
无需仓库：在 Chat 里直接说"用 Archify 画：浏览器 → API → Redis 缓存 → PostgreSQL 兜底"。要源码证据就打开仓库，要求"分析这个仓库再用 archify 出高层运行时架构图，8~12 个核心组件、一条主路径、外部依赖和信任边界"。生成后用 `add Redis`、`move auth to the left` 这类局部指令迭代。它支持 `npx skills add tt-a1i/archify -g` 安装，也支持 Cursor、Codex、OpenCode、Claude Code 等 4 类切换器和 Raven ZIP 手动安装。
它强调"布局判断"而不是"通用自动布局"：Agent 自己决定层级、间距、路由和重点；共享自动端点会确定性分散而不是所有箭头堆一个中点。每张"展示级"图都要通过 schema/layout/HTML/路由/标签-路由净空五道关，任意一道挂了，校验器给出机读 receipt 告诉 Agent 改哪个节点——不是栈追踪也不是模糊重试。桌面预览还有"上一份成功图保留"的兜底：保存失败不替换，避免半成品覆盖已发布的图。
架构师、技术评审者、写技术文档/分享稿的人、要做"PR 改了什么"可视化对比的工程团队，以及任何想让 AI Agent 画出来的图"经得起别人检查"的人。它不适合画风格自由插画、不试图取代 Mermaid 的随手语法，也不是 WYSIWYG 编辑器——它的强项是"严谨的可分享架构图"。