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