tt-a1i/archify
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
這是什麼
Archify 是一個面向 AI coding agent 的 Agent Skill：使用者給它一段系統描述或一個程式碼倉庫，它會協助產生可互動、可分享的技術地圖。它不是單純把文字丟進通用繪圖工具，而是把技術意圖轉成 typed JSON IR，再透過驗證與渲染流程輸出自包含 HTML，以及 PNG、SVG、WebM、1200×630 分享卡等格式。README 強調它支援 Architecture、Workflow、Sequence、Data Flow、Lifecycle 五種圖型，能用在架構說明、流程梳理、API 呼叫、資料流與狀態生命週期。另一個核心賣點是「可信」：搜尋節點、追蹤上下游、路徑探查、角色比較與 guided story 都基於已撰寫的節點與關係，不宣稱未被描述的拓樸或 runtime 影響。
為什麼上榜
這次 tt-a1i/archify 以 17,866 stars、日增 1,035 stars 登上日榜，熱度很明顯踩在兩個趨勢交會點：一是 coding agent 正在變成開發者日常工具，二是團隊越來越需要把大型程式庫與系統設計轉成可審查、可簡報的視覺化成果。README 反覆區分 Archify 與 Mermaid theme 或一般繪圖編輯器：它主打的是 agent 參與的 diagram-as-code 工作流，包含 schema、layout、HTML/SVG、route、label-to-route clearance 等檢查，並在失敗時回傳 machine-readable diagnostics。這讓它不只是「畫得漂亮」，而是嘗試把架構圖從一次性投影片，推向可驗證、可迭代、可交付的工程產物。
適合誰，可以拿來做什麼
Archify 適合需要把系統講清楚的開發者、架構師、技術主管與使用 AI coding agent 的團隊。README 列出的 agent 目標包含 Raven、Cursor、Claude Code、Codex CLI、OpenCode；如果你已經在用這些工具分析倉庫、規劃改版或做 PR review，Archify 可以把對話中的架構理解落成互動文件。典型用途包括：為既有倉庫建立高階 runtime architecture；把登入、快取未命中、CI/CD、部署回滾等流程畫成 sequence 或 workflow；用 Architecture Delta 比較 Before / Delta / After，檢視被新增、移除、變更、移動或重新路由的 authored facts。它比較像工程溝通與審查工具，不是自由拖拉式白板；上手門檻則主要在於能清楚限制圖的範圍與要求，例如指定 8–12 個核心元件、主要路徑、外部依賴與信任邊界。
上手
README 提供了直接的安裝與試用方式。全域安裝 Skill 的基本指令是：
npx skills add tt-a1i/archify -g
若使用 Cursor，README 也給了非互動式全域安裝範例：
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
想先試用、不安裝，則可用：
npx skills use tt-a1i/archify@archify --agent codex
安裝後可以直接請 agent：「Use archify to map this repository's runtime architecture.」README 建議一開始先要求 bounded view，例如限制核心元件數量、主要路徑、外部依賴與信任邊界，再用對話逐步補 Redis、調整位置或突出 rollback path。
README 重點摘要
- 支援 五種圖型：Architecture、Workflow、Sequence、Data Flow、Lifecycle，分別對應元件架構、流程、互動時序、資料流與狀態生命週期。
- 輸出強調 portable by default：結果是自包含 HTML，並可匯出 PNG、SVG、WebM 與 1200×630 分享卡。
- 以 typed JSON IR 與 deterministic checks 為核心，README 提到 schema、layout、HTML/SVG、route、label-to-route clearance 等驗證。
- 互動功能包含搜尋節點、上下游追蹤、directed route 探查、角色比較、guided story、Presentation Stage、主題切換與匯出選單。
- README 明確定位：Archify 不是一般繪圖編輯器或 Mermaid theme，而是把技術意圖轉成可審查、可分享的溝通 artifact。