一句話說清楚
Archify 是一個 Agent Skill（代理技能）：你用一句話、一個問題或一個計畫向 AI 代理描述，它幫你產出一份可探索、可客製、可分享的互動式 HTML 圖表。從旅行行程、學習地圖到複雜系統架構都可以做成自己的圖。1
Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.接著繼續說：「加上認證」、「標出 cache-miss 路徑」或「切到淺色主題」——圖會跟著你的對話長大。
💡 關鍵心智模型：Archify 不是叫你去拖方塊的繪圖編輯器，而是技術意圖 → 溝通產物的管線。你負責講清楚意圖，代理負責寫型別化 JSON、跑驗證、交付 HTML。
Archify 不是什麼
官方把範圍說得很清楚，以下刻意不在範圍內：1
| 不是 | 說明 |
|---|---|
| 通用繪圖編輯器 | 不提供所見即所得拖拉編輯 |
| Mermaid 佈景主題 | 讀 Mermaid 是為了拓撲與語意，然後重寫成 Archify JSON，而非套皮 |
| 自動 Mermaid 解析 | 不做機械式 Mermaid 樣式轉換 |
| 通用自動排版 | 由代理做版面判斷（階層、間距、路徑、強調），而非套通用演算法 |
| 託管分享服務 | 結果就是一個自包含 HTML 檔，自己傳送、自己託管 |
| 所見即所得編輯 | 迭代靠改 JSON 原始檔再重新驗證交付 |
三個核心觀念
1. 型別化 JSON IR (Intermediate Representation)
每個 renderer-backed 模式都有自己的 schema 與可重現原始檔。代理不是直接畫 SVG，而是先寫一份型別化 JSON（例如 candidate.json），通過驗證後才渲染成 HTML。這份 JSON 就是圖的「源碼」：可版本控制、可 diff、可針對性迭代。2
2. 驗證後才交付 (Validated delivery)
finalize 依序跑 showcase validation → validate → deliver → 嚴格 check → 真實瀏覽器 browser-check，任一閘門失敗就停在該閘門，並附帶機器可讀的修復收據（rule code、精確 subject、量測證據、僅允許的修復控制）。只有全過的產物才會原子取代目標檔。2
3. 可攜式預設 (Portable by default)
結果是單一 HTML 檔：內嵌 SVG、深色/淺色主題、檢視器互動都跟著檔案走。下載後用瀏覽器開啟即可探索，不需安裝 Archify；傳給別人互動也跟著走（外部網站與地圖連結仍需網路）。1
從哪裡開始
- 互動範例：Live demos（官方 gallery）
- 情境指南：Scenario guide
- 選代理：Choose your agent
- 本主題下一課：安裝與起始流程