CI 里跑架构校验Archify 接入流水线的三种姿势【免费下载链接】archifyTurn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.项目地址: https://gitcode.com/GitHub_Trending/arch/archify当 AI 编码助手开始批量改代码架构图成了最先失真的文档——PR 里悄悄加了一个服务、拆了一条依赖、挪了一层边界没人会记得回头更新那张 PPT。社区里对 Archify 的讨论几乎都绕不开同一个词可核验CSDN 多篇实测把它定位为架构图与代码自动对账、CI 级自动校验本周 GitHub 热榜上它再度登顶靠的不是画图好看而是把架构从文档变成了可以被机器裁决的输入。Archify 的核验内核足够硬才有资格进流水线AI 生成结构化 JSON确定性程序渲染与校验schema、布局、HTML/SVG、路由、标签避让逐项 fail-closed失败时给出机器可读的稳定诊断码而不是一段 Node 堆栈。这篇文章不评价它画得美不美只回答一个问题把 Archify 的校验装进 CI有哪几种接法各自解决什么问题以下内容全部基于仓库源码与真实命令你可以直接复制到自己的流水线里。漂移为什么必须失败即停架构校验进 CI 的第一原则是校验器必须比审阅者更严格且失败必须中断流程。Archify 的交付契约delivery-contract.md把这条写成了代码级约定机器回执而非人类话术。validate --json、deliver --json输出单一 JSON 对象按arguments / input / prepare / render / check / receipt / commit阶段归类失败携带稳定 rule code、具体对象、测量证据与supportedFixes参数错误固定 exit status 2非零退出永远不算成功。CI 脚本可以精确 grep 诊断码来给 PR 打注释而不是解析自然语言。原子交付。deliver把输入的 specification 字节快照写入同目录私有候选渲染该快照跑完整 artifact 检查全部通过后才原子替换目标文件任何失败都删除候选并逐字节保留旧 artifact。回执同时给出 specification 与 artifact 的 SHA-256 与字节数——这次 PR 改了什么有了可对账的哈希。Provenance 可追溯。check output.html --require-provenance把没有交付边车.delivery.json、journal、lock的产物直接判为失败防止 CI 里出现来路不明的 HTML。头条那篇交图前过五道校验说的就是finalize的一键链路内嵌校验 → 原子交付 → 严格 provenance 检查 → 真实浏览器检查四道门串成一条 fail-closed 管线中途任何一道失败即停输出stem.finalize-summary.json供修复使用。姿势一命令行直接接入当最严格的 lintArchify 的 CLIarchify/bin/archify.mjs零依赖、Node 18意味着 CI runner 上不需要npm installcheckout 下来直接能跑。五个 JSON Schema 在构建期被编译成提交进仓库的独立 ESM 校验器见 generate-validators.mjs 与 CHANGELOG.md无node_modules、无网络也能完成完整 schema 校验——这是它适合进流水线的关键设计。把校验挂在 PR 上的最小 GitHub Actions 片段- uses: actions/checkoutv5 - uses: actions/setup-nodev5 with: node-version: 22 - name: 校验架构源文件 run: node archify/bin/archify.mjs validate architecture docs/architecture.json --quality showcase --json - name: 渲染并原子交付 run: node archify/bin/archify.mjs deliver architecture docs/architecture.json docs/architecture.html --quality showcase --json--quality showcase意味着走严格档回执要求九项 artifact 检查全过、零组合错误、零警告而不是能画出来就行。交付成功后生成的 HTML 还可被下游browser-check用真实浏览器再验一轮渲染稳定性。值得强调的是Archify 对自己的 CI 就是按这个标准 dogfooding 的.github/workflows/ci.ymlNode 18/20/22/24 矩阵跑 golden file 与 schema 测试重建archify.zip并逐字节 diff陈旧直接报错用真实 Chrome 解码 WebM 动画产物拒绝静态帧校验稳定版清单必须与已发布的 Release 字节一致。一个画图工具把发布物、更新清单、跨平台路径契约全部纳入 CI恰好示范了校验进流水线能做到多深。姿势二Skill 触发让 AI 自己过闸第二种姿势面向AI 已经在改代码的现实让生成架构图的 Agent 自己把校验跑完再把证明带回来。Archify 本身就是一个 Agent Skill安装即用npx skills add tt-a1i/archify -g装进 Claude Code 的~/.claude/skills/、Codex CLI 的~/.agents/skills/或 Cursor、opencode、GitHub Copilot 对应目录后SKILL.md 就变成了 Agent 的硬性工作流完整首稿直接finalize禁止先出临时图非零退出永不视为成功失败按回执的supportedFixes修复且只有两轮修复配额成功回执必须如实汇报自动化检查通过不得谎称做过视觉审阅。对 CI 而言这意味着校验逻辑被前置到了生成现场Agent 在本地编辑器里改完候选 JSON先自己跑一遍finalize通过后再 push。CI 上的validate不是第一道防线而是对 Agent 自检的复核——同一套诊断码本地和流水线两侧共享。更新检查ARCHIFY_UPDATE_CHECK_DISABLED1可关闭也是 bounded 的只提醒、绝不自动安装离线 runner 不会有任何网络依赖。姿势三定时对账抓慢性漂移PR 门禁挡得住这次改动挡不住三个月没人碰的慢性漂移。第三种姿势是把 Archify 的 compare 能力做成 nightly 对账任务让架构基线自己过期。compare对比已校验的 Before / Delta / After 快照并输出机器回执checkout-platform-delta.receipt.json 是仓库内的真实样例组件与连接的 added / changed / removed / moved 数量、边界变化、presentation 与 provenance 是否变动全部结构化。仓库里那张对比示意展示了同一架构两个版本间新增了组件、改了连接、移了边界的可视化结果。定时任务只需三行核心逻辑schedule: - cron: 0 2 * * * # 每天凌晨对账 steps: - run: node archify/bin/archify.mjs compare architecture baseline.json current.json delta.html --json对账的意义不只是发现漂移而是把漂移变成可归因的差异回执里的rawSha256与semanticSha256双哈希能区分换了个空格和拓扑真变了provenanceChanged标记仓库版本、来源链接模式是否被改。凌晨的 job 把 delta 回执写进 issue 或存档比年底补一张架构图靠谱得多。与 Codex CLI 串成一条链三种姿势不是互斥的它们在AI 从建议者变成执行者的工作流里正好串成一条闭环。以 Codex CLI 为例Archify 官方支持它作为 Skill 宿主README 的安装表明确给出~/.agents/skills/路径本地生成开发者在 Codex CLI 里描述系统Agent 按 Skill 契约生成候选 JSON--repo-root指向仓库时每个组件节点都会携带sources文件路径 行范围并绑定到固定 commit 校验 Git 顶层、origin、blob 与行界——证据不足的节点直接标为未知绝不脑补repository-authoring.md。提交前自检Agent 本地finalize过完四道门回执里带 SHA-256 和浏览器证据。流水线复验PR 触发姿势一的validatedeliverCI 对同一份候选重算哈希与检查失败即 merge 门禁亮红。定时对账合入后nightly 的compare持续追踪基线漂移哪天发现sources指向的代码行已经和图上不一致delta 回执会精确指出是哪个组件、哪条连接变了。这条链的关键不在工具数量而在每一环都产出同一格式的机器回执本地 Agent、CI runner、定时任务共享诊断码与哈希约定谁都可以验证上一环的结论。对于把 CI/CD 流程本身画成图的需求Archify 的workflow类型SKILL.md 的 Type 路由将其定位为CI/CD、审批门、runbook还能把流水线结构可视化——用画 CI 的工具校验架构再用它把 CI 画出来闭环就完整了。架构文档的宿命曾经是画完即过期。当校验器能进 PR 门禁、能随 Agent 一起写代码、能在深夜自动对账时架构图第一次获得了和单元测试同等的地位不是记录而是约束。【免费下载链接】archifyTurn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考