Archify - README

tt-a1i/archify 官方 README。Archify 是一个 agent skill：给 Cursor / Claude Code / Codex CLI / OpenCode 用，把代码库或系统描述变成可交互、可校验的架构图。抓取时 24.4k star / 1.6k fork，Trendshift 榜在列，社区在 LINUX DO。

要点

• 是什么：Node.js 渲染 + 校验系统。Agent 分析代码后产出 typed JSON IR（带 schema 的中间表示），Archify 确定性编译成单文件自包含 HTML/SVG。模型只写 JSON、不直接画图，结果可复现。
• 交付质量闸门：schema / 布局 / 连线 / 标签间距检查全过才替换上一份产物；失败时返回机器可读诊断（rule code + 定位 + 支持的修复动作），agent 只做定点修复，最多两轮。
• 5 种图型：Architecture、Workflow、Sequence、Data Flow、Lifecycle，各有模板与 guide 命令帮你选型。
• 交互查看器：搜索节点、Upstream / Downstream authored reach、route probe（两节点间路径）、role lens 对比、guided story、演示模式；可选打开 Git commit 校验过的源码行（Evidence-backed 模式）。
• Architecture Delta：compare 命令对比两份快照，生成 Before / Delta / After——added / removed / changed / moved / rerouted 的机器收据，面向 PR 审查。
• 导出：PNG（剪贴板/文件）、SVG、WebM、1200×630 分享卡片；深浅主题。
• 明确不做什么：不解析 Mermaid、不是 WYSIWYG 编辑器、不做通用自动布局——定位”把技术意图变成沟通产物”，不是画图工具。
• 出身：2026-04 从 Cocoon-AI/architecture-diagram-generator（MIT v1.0）fork 重写；MIT 协议；开发版迭代极快（v2.16.0-dev，184 commits）。

值得留的原话

“Archify is not a general-purpose drawing editor or a Mermaid theme. It turns technical intent into a communication artifact.”（README, Reference and scope 节）

“Failures come with a repair receipt — validate --json and deliver --json return stable rule codes, the exact subject, measured evidence, and only supported repair controls instead of a Node stack or an unstructured retry guess.”（README, Why Archify 节）

上手

npx skills add tt-a1i/archify -g

然后对 agent 说 Use archify to map this repository's runtime architecture。免安装试用：npx skills use tt-a1i/archify@archify --agent codex。在线示例：Proof Lab。

为什么火

Agent skills 生态（npx skills add / Claude Skills / Codex skills）起来后，“让 agent 出高质量架构图”是刚需：模型直接吐 Mermaid 或 SVG 质量不稳定，Archify 用”模型只写 JSON + 确定性渲染 + 校验闸门”解决，还附带分享卡片这类传播友好功能，star 曲线很陡。

关联

• Archify — 实体页
• AI 领域
• 同为 agent skill 生态实例：Warp - Self-Improving Agents on Claude 把 skill 当程序性知识载体（自改进 Agent 回路），Archify 则是”skill = 确定性工具链”路线——skill 不只是提示词，也可以捆绑渲染器与校验器。