Archify的終極定位它為什么不是繪圖工具而是“通信工件”生成器【免費下載鏈接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>項目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一款給 AI 編碼助手Cursor、Claude Code、Codex CLI 等使用的 Agent 技能它把代碼庫或系統(tǒng)描述變成可驗證、可分享、可演示的技術(shù)圖——架構(gòu)、工作流、時序、數(shù)據(jù)流、狀態(tài)機(jī)五種最終產(chǎn)出一個自包含的 HTML“通信工件”。這篇文章解釋它為什么刻意拒絕繪圖工具的敘事。一句話定位它把技術(shù)意圖變成“通信工件”在README.md的 “Why Archify” 一節(jié)里有一句話足以定義整個項目Archify is not a general-purpose drawing editor or a Mermaid theme. It turns technical intent into a communication artifact. Archify 不是通用繪圖編輯器也不是 Mermaid 主題。它把技術(shù)意圖轉(zhuǎn)化為通信工件?！巴ㄐ殴ぜ眂ommunication artifact是全文關(guān)鍵詞。它的意思是產(chǎn)物不是“一張圖”而是一份可以被檢查、被轉(zhuǎn)發(fā)、被演示、被復(fù)核的溝通載體。判斷標(biāo)準(zhǔn)也隨之改變——繪圖工具問“畫得好不好看”Archify 問的是三件事?可驗證圖里每一條邊、每一個節(jié)點都有類型化來源且通過了確定性校驗可分享一個 HTML 文件走天下不依賴任何托管服務(wù)可演示能按章節(jié)講故事、能精確追溯路徑且不虛構(gòu)拓?fù)錇槭裁床皇抢L圖工具三次刻意缺席想理解定位先看它主動放棄了什么。缺席一沒有畫布式編輯器PRODUCT.md的 Anti-references反參考一節(jié)開宗明義WYSIWYG 繪圖套件“編輯外殼變成產(chǎn)品本身”是被拒絕的形態(tài)。你不會在 Archify 里拖拽方框、調(diào)手柄——你只需要在對話里用自然語言描述系統(tǒng)AI 負(fù)責(zé)產(chǎn)出帶類型的 JSON渲染器負(fù)責(zé)確定性編譯。缺席二沒有自動布局引擎更狠的是項目在ROADMAP.md里公開給自動布局dagre / elk-js判了死刑標(biāo)注為KILLED理由是實驗數(shù)據(jù)。盲測方法寫在experiments/v3-mermaid-validation/RESULT.md取 5 張真實 Mermaid 圖各渲染 3 個版本——A 原生 Mermaid、B 換上 Archify 配色但布局不動、C 由 AI 做語義布局15 張截圖去標(biāo)簽盲評結(jié)論只有一行C looks good; A and B both dont look good. B is not meaningfully better than A.結(jié)論很扎心換皮不換布局審美差距無法彌合。架構(gòu)圖的價值不來自配色而來自空間敘事——Auth Provider 為什么畫在云區(qū)域外面、緩存為什么壓在 CDN 下方這些是語義判斷不是排版算法能給的。缺席三沒有托管分享gzipbase64 分享鏈接、?exportScale縮放參數(shù)這些“方便功能”也都被砍掉理由寫在ROADMAP.mdXSS 攻擊面、URL 長度限制以及一個樸素的事實——今天把 HTML 文件直接發(fā)給同事已經(jīng)比任何鏈接都自然。三次缺席指向同一個判斷“更好看的 Mermaid”是已占領(lǐng)的賽道Archify 選的窄賽道是信息架構(gòu)。工件如何生成類型化 JSON 確定性校驗定位不是口號管線里每一步都在兌現(xiàn)它類型化 JSON IR五種圖表類型各有獨立 Schema見archify/schemas/每個節(jié)點和關(guān)系都有類型不允許“發(fā)明字段”原子化校驗Schema、布局規(guī)則、HTML/SVG 完整性、標(biāo)簽與連線避讓全部通過才允許交付失敗時返回帶規(guī)則碼和精確修復(fù)建議的診斷AI 可以據(jù)此自我修復(fù)機(jī)器回執(zhí)receiptdeliver命令只替換“通過全部檢查的候選產(chǎn)物”并輸出兩份 SHA-256 摘要——規(guī)格與工件各一份。契約細(xì)節(jié)見archify/references/delivery-contract.md這就是“通信工件”和“圖片”的本質(zhì)區(qū)別圖片可以被質(zhì)疑工件自帶證據(jù)鏈。工件的另一面一鍵導(dǎo)出與精確分享生成之后工件的通信能力體現(xiàn)在導(dǎo)出上PNG、SVG、WebM以及一張標(biāo)準(zhǔn) 1200×630 的分享卡片專門適配 README、Release 和社交帖。更妙的是Route Share Card先追溯一條“用戶 → API 服務(wù)”的精確路徑再單獨導(dǎo)出這條路徑為分享卡片其余部分保留為暗色上下文。分享的是一個明確劃定的閱讀范圍而不是“整張圖的縮略圖”——不夸大、不失真。Before / Delta / After在合并前評審架構(gòu)變更通信工件最硬核的應(yīng)用場景是架構(gòu)變更評審。compare命令可以把兩份已驗證的架構(gòu)快照對比成 Before / Delta / After 三視圖右上角直接給出機(jī)器統(tǒng)計新增 2、刪除 2、變更 5。每一條變更——新增、移除、修改、移動、改道——都是精確的作者化事實而不是“看起來好像變了”的模糊印象。評審者點開 Delta看到的不是兩張貼圖的差異色塊而是“Session Cache 移入信任區(qū)域、Fraud Gate 新增策略掃描職責(zé)”這樣的可陳述事實。這才是架構(gòu)圖在代碼評審中真正能起到的作用。誠實的交互圖上不出現(xiàn)任何虛構(gòu)拓?fù)渥詈笠粭l定位紅線寫在PRODUCT.md的設(shè)計原則里Truth before spectacle真實先于炫技。查看器提供搜索聚焦、上下游可達(dá)性追溯、路徑探測、角色對比、引導(dǎo)式故事播放——但所有交互都只復(fù)用作者化authored的節(jié)點與關(guān)系絕不推斷運行時影響、絕不發(fā)明不存在的邊。你看到什么工件里就有什么僅此而已。小結(jié)知道自己不是什么比知道自己是什么更值錢把三次缺席和一條紅線拼在一起Archify 的輪廓就清晰了它拒絕的它堅持的WYSIWYG 畫布編輯自然語言 類型化 JSON自動布局引擎AI 做語義布局判斷渲染器只做確定性約束托管分享鏈接自包含單文件 標(biāo)準(zhǔn)分享卡片好看的圖可驗證、可分享、可演示、可復(fù)核的通信工件下次當(dāng)你需要向團(tuán)隊解釋一個系統(tǒng)的請求路徑、或在 PR 里評審架構(gòu)變更時不妨試試npx skills add tt-a1i/archify -g然后對 AI 說一句“用 archify 畫出這個倉庫的運行時架構(gòu)突出主路徑與信任邊界?！?你得到的將不是一張圖而是一份可以被任何人打開、檢查、轉(zhuǎn)發(fā)并信任的通信工件?！久赓M下載鏈接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>項目地址: https://gitcode.com/GitHub_Trending/arch/archify創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考