跳至主要内容

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

一句話畫出可互動的架構圖

🎯 一行簡述:用文字描述或讀一個 repo,產出單一 HTML 檔的互動圖(架構、流程、時序、資料流、狀態)。

基本資料​

項⁠目說明
出⁠自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。

它怎麼運作​

  1. 代理人先選圖型,再依該圖型的 schema 寫出一份 JSON 描述檔(節點、連線、分組),而不是直接畫 SVG
  2. validate 檢查 schema、版面、HTML/SVG 與連線路徑;失敗時回報規則代碼、出問題的對象與可用的修法
  3. deliver 通過全部檢查才寫出 HTML,失敗時保留上一版輸出,不會把壞圖覆蓋掉好圖
  4. 之後說「加一個 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。