archify

把一段代码库或系统描述，直接在对话里变成一张可交互、可验证、可分享的技术地图。

解决什么问题

讲解系统架构、评审改动，通常要靠通用绘图工具一张张手动画，既费时又容易和真实代码脱节。archify 是一个 agent 技能，让会话内的 agent 把代码库或一段描述直接转成结构化、可验证的架构图——架构 / 工作流 / 时序 / 数据流 / 生命周期五类图，覆盖从整体架构到单次交互。

它不只是”画得好看”。每次渲染都经过类型化 JSON IR 与确定性校验：交付前 schema、布局、HTML/SVG、路由等检查必须全部通过，失败时给出可机器阅读的修复凭据；Architecture Delta 还能对比 Before / Delta / After 三张快照，精确列出新增、删除、变更、移动与改线。评审架构改动，看的是已验证的事实，而不是凭感觉的图。

核心功能

• 五类图：架构 / 工作流 / 时序 / 数据流 / 生命周期，各自匹配不同场景
• 可交互查看器：搜索节点、追踪上游/下游可达、探查精确路由、对比语义角色、播放引导故事，只复用已编写的节点关系，不凭空编造拓扑
• Architecture Delta：对比验证过的 Before / Delta / After 快照，用机器凭据列出新增、删除、变更、移动与改线
• 原子校验交付：schema、布局、HTML/SVG、路由检查全部通过，才替换上一份已知良好产物
• 自包含产物：单一 HTML 文件，另可导出 PNG、SVG、WebM 与 1200×630 分享卡片，深色/浅色主题一键切换
• 源证据按需开启：证据型架构节点标记 SRC n，可打开钉在公开 commit 上、经 Git 校验的文件行范围
• 多 agent 适配：支持 Raven、Cursor、Claude Code、Codex CLI、OpenCode 及 DSH 社区集成

快速上手

安装：

dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0

装完在对话里直接说：

Use the archify skill to map this repository’s runtime architecture.

也可以给更具体范围，例如”画一张 8–12 个核心组件的高层运行时架构图”。生成后用自然语言微调（“把 Redis 加进去""把 auth 移到左边”），类型化源文件保留下来支持定向迭代。其他 agent 环境可用 npx skills add tt-a1i/archify -g 安装。

适合谁

• 需要在评审、文档、讲解中产出可信架构图的开发者与架构师
• 想在做设计 / PR 评审时对比改动前后差异的团队
• 希望把”画图”也交给会话内 agent 完成的 DSH 用户