Archify的终极定位它为什么不是绘图工具而是“通信工件”生成器【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一款给 AI 编码助手Cursor、Claude Code、Codex CLI 等使用的 Agent 技能它把代码库或系统描述变成可验证、可分享、可演示的技术图——架构、工作流、时序、数据流、状态机五种最终产出一个自包含的 HTML“通信工件”。这篇文章解释它为什么刻意拒绝绘图工具的叙事。一句话定位它把技术意图变成“通信工件”在README.md的 “Why Archify” 一节里有一句话足以定义整个项目Archify is not a general-purpose drawing editor or a Mermaid theme. It turns technical intent into a communication artifact. Archify 不是通用绘图编辑器也不是 Mermaid 主题。它把技术意图转化为通信工件。“通信工件”communication artifact是全文关键词。它的意思是产物不是“一张图”而是一份可以被检查、被转发、被演示、被复核的沟通载体。判断标准也随之改变——绘图工具问“画得好不好看”Archify 问的是三件事✅可验证图里每一条边、每一个节点都有类型化来源且通过了确定性校验可分享一个 HTML 文件走天下不依赖任何托管服务可演示能按章节讲故事、能精确追溯路径且不虚构拓扑为什么不是绘图工具三次刻意缺席想理解定位先看它主动放弃了什么。缺席一没有画布式编辑器PRODUCT.md的 Anti-references反参考一节开宗明义WYSIWYG 绘图套件“编辑外壳变成产品本身”是被拒绝的形态。你不会在 Archify 里拖拽方框、调手柄——你只需要在对话里用自然语言描述系统AI 负责产出带类型的 JSON渲染器负责确定性编译。缺席二没有自动布局引擎更狠的是项目在ROADMAP.md里公开给自动布局dagre / elk-js判了死刑标注为KILLED理由是实验数据。盲测方法写在experiments/v3-mermaid-validation/RESULT.md取 5 张真实 Mermaid 图各渲染 3 个版本——A 原生 Mermaid、B 换上 Archify 配色但布局不动、C 由 AI 做语义布局15 张截图去标签盲评结论只有一行C looks good; A and B both dont look good. B is not meaningfully better than A.结论很扎心换皮不换布局审美差距无法弥合。架构图的价值不来自配色而来自空间叙事——Auth Provider 为什么画在云区域外面、缓存为什么压在 CDN 下方这些是语义判断不是排版算法能给的。缺席三没有托管分享gzipbase64 分享链接、?exportScale缩放参数这些“方便功能”也都被砍掉理由写在ROADMAP.mdXSS 攻击面、URL 长度限制以及一个朴素的事实——今天把 HTML 文件直接发给同事已经比任何链接都自然。三次缺席指向同一个判断“更好看的 Mermaid”是已占领的赛道Archify 选的窄赛道是信息架构。工件如何生成类型化 JSON 确定性校验定位不是口号管线里每一步都在兑现它类型化 JSON IR五种图表类型各有独立 Schema见archify/schemas/每个节点和关系都有类型不允许“发明字段”原子化校验Schema、布局规则、HTML/SVG 完整性、标签与连线避让全部通过才允许交付失败时返回带规则码和精确修复建议的诊断AI 可以据此自我修复机器回执receiptdeliver命令只替换“通过全部检查的候选产物”并输出两份 SHA-256 摘要——规格与工件各一份。契约细节见archify/references/delivery-contract.md这就是“通信工件”和“图片”的本质区别图片可以被质疑工件自带证据链。工件的另一面一键导出与精确分享生成之后工件的通信能力体现在导出上PNG、SVG、WebM以及一张标准 1200×630 的分享卡片专门适配 README、Release 和社交帖。更妙的是Route Share Card先追溯一条“用户 → API 服务”的精确路径再单独导出这条路径为分享卡片其余部分保留为暗色上下文。分享的是一个明确划定的阅读范围而不是“整张图的缩略图”——不夸大、不失真。Before / Delta / After在合并前评审架构变更通信工件最硬核的应用场景是架构变更评审。compare命令可以把两份已验证的架构快照对比成 Before / Delta / After 三视图右上角直接给出机器统计新增 2、删除 2、变更 5。每一条变更——新增、移除、修改、移动、改道——都是精确的作者化事实而不是“看起来好像变了”的模糊印象。评审者点开 Delta看到的不是两张贴图的差异色块而是“Session Cache 移入信任区域、Fraud Gate 新增策略扫描职责”这样的可陈述事实。这才是架构图在代码评审中真正能起到的作用。诚实的交互图上不出现任何虚构拓扑最后一条定位红线写在PRODUCT.md的设计原则里Truth before spectacle真实先于炫技。查看器提供搜索聚焦、上下游可达性追溯、路径探测、角色对比、引导式故事播放——但所有交互都只复用作者化authored的节点与关系绝不推断运行时影响、绝不发明不存在的边。你看到什么工件里就有什么仅此而已。小结知道自己不是什么比知道自己是什么更值钱把三次缺席和一条红线拼在一起Archify 的轮廓就清晰了它拒绝的它坚持的WYSIWYG 画布编辑自然语言 类型化 JSON自动布局引擎AI 做语义布局判断渲染器只做确定性约束托管分享链接自包含单文件 标准分享卡片好看的图可验证、可分享、可演示、可复核的通信工件下次当你需要向团队解释一个系统的请求路径、或在 PR 里评审架构变更时不妨试试npx skills add tt-a1i/archify -g然后对 AI 说一句“用 archify 画出这个仓库的运行时架构突出主路径与信任边界。” 你得到的将不是一张图而是一份可以被任何人打开、检查、转发并信任的通信工件。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考