Archify:把代码库或系统描述变成可验证的交互式架构图
Archify: turn a codebase or system description into a verifiable, interactive system map
在 Cursor、Claude Code、Codex CLI、OpenCode 里直接生成架构、工作流、时序、数据流、生命周期五类图的 Agent Skill:Agent 产出带类型的 JSON 中间表示,Archify 确定性地编译成单文件 HTML/SVG,交付前通过 schema、布局、路由、标签间距等检查,支持搜索节点、追溯上下游、对比两个版本的差异,并导出 PNG/SVG/WebM 和 1200×630 分享卡。
要点
- 不需要仓库也能用:在对话里写一句 "Browser -> API -> Redis cache -> PostgreSQL fallback" 就能出图;给仓库则可让节点挂上按 commit 固定的源码文件与行号。
- Agent 负责层级、间距、路线与强调等布局判断,渲染由带 schema 的 JSON IR 驱动,同一份源可复现、可定向修改("add Redis"、"move auth to the left")。
- 交付前原子校验:schema、布局、HTML/SVG、路由、标签与线的间距全部通过才替换上一次的好版本;失败时 validate --json 返回稳定的规则码和可用的修复项,而不是堆栈。
- 查看器里的交互都基于作者写进去的拓扑:聚焦节点、上下游影响范围、最短有向路径、角色对比、分章节的引导故事,不会凭空编造连线。
- 两个校验过的快照可做 Before / Delta / After 对比,精确列出新增、删除、修改、移动和改路的关系,适合合并前审查架构变更。
- 输出是一个 HTML 文件,暗/亮主题、四种视觉预设、有限动画;导出的 PNG/SVG/WebM 与分享卡不带临时查看状态。
安装 / 使用
npx skills add tt-a1i/archify -g

