技能介绍

要解决的问题

评审仓库时最常见的情况是：架构描述散落在 README、PR 描述和几个人的记忆里。让 AI 直接“画一张架构图”，往往得到一张箭头乱飞、层级含糊的示意图——图中的节点是否真实存在于代码里无从验证，merge 之前更是无法对比变化。Archify 要处理的就是这件事：把技术意图转成可校验、可分享的沟通产物，而不是一张随手生成的贴图。

核心能力

五类图各司其职：Architecture 描述组件与边界，Workflow 覆盖 CI/CD 与审批流，Sequence 刻画调用时序，Data Flow 标注数据血缘与敏感边界，Lifecycle 表达状态、重试与终态。
类型化 JSON IR：所有渲染模式都有 schema，产物可复现、可 diff，而不是黑盒截图。
交付前原子校验：schema、布局、HTML/SVG、路由、标签间距必须全部通过，通过的产物才会原子替换上一次已知良好的输出；失败时返回机器可读的 diagnostics[]，指出具体出错对象和受支持的修复方式，而不是抛出 Node 堆栈。
诚实的交互：搜索节点、上下游追踪、路由探测、角色对比、引导故事都只基于你写入的节点与关系，不会凭空发明拓扑，也不会宣称运行时影响。
变更评审：Architecture Delta 对比 Before / Delta / After 三个快照，精确列出新增、删除、修改、移动、改线的条目，只作 viewer 展示，不推断风险或合并安全性。

工作流程

Agent 先从你的描述生成类型化 JSON 源，本地校验器与布局规则检查通过后才渲染。可选的 preview 模式只绑定 127.0.0.1 上的一个 JSON 文件，保存未通过校验时保留上一次合格的产物；交付时候选文件先渲染检查，通过才原子替换目标，再按需打开该文件。

适用边界

它不是通用绘图编辑器，也不是 Mermaid 主题：不做 Mermaid 自动解析、不做通用自动布局、不做托管分享、不做所见即所得编辑。可选的 SRC 证据节点会把 Git 校验过的文件与行号钉在指定 commit 上，但普通产物默认不含源码引用；部署评审 profile 在缺少 owner、区域归属等信息时 fail closed。它校验的是编写的事实，不是真实基础设施。