21|一句話畫出可互動的架構圖(tt-a1i/archify)

🎯 一行簡述:用文字描述或讀一個 repo,產出單一 HTML 檔的互動圖(架構、流程、時序、資料流、狀態)。
- Repo:https://github.com/tt-a1i/archify(MIT;官網 archify.si)
基本資料
| 項目 | 說明 |
|---|---|
| 出自 | tt-a1i(個人,GitHub 帳號類型為 User),官網 archify.si。SKILL.md 標明它改寫自 Cocoon-AI/architecture-diagram-generator(MIT)。 |
| 組織介紹 | 個人專案,不是公司產品。GitHub 個人簡介空白;README 列出贊助商(Kimi Work、Supercode、OpenLux 等),並聲明第三方線上服務與付費方案由各自業者營運,不代表 Archify。 |
| 動機 | repo 未明說作者動機。README 的定位是「把想理解、規劃或分享的東西變成互動視覺」,並寫明它不是通用畫圖編輯器,也不是 Mermaid 主題,而是把技術意圖轉成溝通用成品。 |
| 目的 | 讓 AI 代理人依描述或程式碼,產出能點擊、追路徑、換深淺主題、匯出圖片或影片的單檔 HTML 圖。 |
| 使用方法 | npx skills add tt-a1i/archify -g。支援 Claude Code、Codex CLI、Cursor、OpenCode。安裝後對代理人說「Use Archify to diagram …」即可,不需要有 repo。 |
它怎麼運作
- 代理人先選圖型,再依該圖型的 schema 寫出一份 JSON 描述檔(節點、連線、分組),而不是直接畫 SVG
validate檢查 schema、版面、HTML/SVG 與連線路徑;失敗時回報規則代碼、出問題的對象與可用的修法deliver通過全部檢查才寫出 HTML,失敗時保留上一版輸出,不會把壞圖覆蓋掉好圖- 之後說「加一個 Redis」「把 auth 移到左邊」,代理人改的是 JSON 再重新交付
先寫描述檔、再驗證交付,是它和「叫模型直接吐一張 SVG」最大的差別:版面錯誤由程式擋下,不靠肉眼。
五種圖
| 圖型 | 適合 |
|---|---|
| Architecture 架構 | 元件、服務、儲存、邊界 |
| Workflow 流程 | CI/CD、核准流程、工具呼叫 |
| Sequence 時序 | API 呼叫、快取未命中、認證 |
| Data Flow 資料流 | 管線、資料血緣、個資流向 |
| Lifecycle 生命週期 | 狀態、重試、等待、終態 |
也吃貼進來的 Mermaid(flowchart、sequenceDiagram、stateDiagram)轉成上述格式。
輸出長什麼樣
- 單一 HTML 檔,傳給別人直接開,互動一起帶走(地圖連結需連網)
- 點節點看詳情、追上游/下游、追單一路徑
- 深色/淺色主題切換
- 匯出 PNG、JPEG、WebP、SVG、WebM;追過路徑後可匯出 1200×630 的分享卡
使用時要知道
- 需要 Node:驗證與交付靠
node archify/bin/archify.mjs - 會連網檢查更新:只在交付時 GET 固定的 stable 清單、用來顯示提醒,不會自動安裝;README 稱不會送出版本、專案資料或提示詞。想完全關閉:設環境變數
ARCHIFY_UPDATE_CHECK_DISABLED=1 - 版本會動:README 標示穩定版 3.0.1(2026-09-28),專案仍在密集更新;本文以此版為準,安裝後請以實際版本為準
- 只畫作者描述過的關係:互動裡的上下游、路徑都來自你寫的節點與連線,不代表執行期影響範圍
什麼時候用
- 要向人解釋一個系統,需要「可點、可追路徑」的圖,不是靜態圖
- 讀完一個 repo,想要有來源行號佐證的架構圖(說明 repo 時請它附 source evidence)
- 設計或 PR 審查時比對改動前後(
compare architecture,產出 Before/Delta/After)
只要一張簡單流程圖、貼進文件即可,Mermaid 更輕;要做影片動畫改用 HyperFrames。