Archify 是什麼、怎麼安裝使用：把想法或代碼庫畫成可交互架構圖的 Skill（Claude Code / Codex / Cursor）

本文根據 tt-a1i/archify 倉庫 README、官網 archify.si 與 Claude Code、Codex 官方文檔整理，資料核對於 2026-10-10。命令和支持範圍以倉庫 README 為準。

是什麼

Archify 是一個把「想講清楚的結構」變成可交互圖的 Skill。你向智能體描述一個系統、一個流程，或者讓它先讀一遍代碼庫，Archify 會生成一個獨立的 HTML 文件：裏面是排好版的圖，可以點節點聚焦、沿着上下游追蹤、按路徑講解，還能切換視覺風格和深淺主題，再導出圖片分享。

它不是通用繪圖編輯器，也不是 Mermaid 的換膚。README 描述的做法是：智能體先按固定的數據格式（帶 schema 的 JSON）寫出圖的「源」，倉庫自帶的校驗器檢查結構、佈局、連線和標籤是否互相遮擋，全部通過才渲染成最終文件；沒通過會返回具體的修復提示讓智能體改。這樣做的好處是圖可以反覆修改而不亂——後續說一句「加上 Redis」「把鑑權挪到左邊」，它只改源文件裏相關的部分。

截至 2026-10-10，GitHub 顯示該倉庫約 8.1 萬 Star、5498 Fork，最近一次推送在 2026-10-10，README 標註的穩定版本為 v3.0.1。倉庫有簡體中文 README（README_ZH.md）。

包含哪些 Skill

倉庫只有一個技能 archify，支持五種圖：

• Architecture（架構圖）：組件、服務、存儲和邊界。提示裏說明範圍、核心組件和主路徑；
• Workflow（流程圖）：CI/CD、審批、工具調用、操作手冊。說明參與者、順序、分支和異常；
• Sequence（時序圖）：一次 API 調用、緩存回退、鑑權、異步鏈路。說明調用方、被調用方和返回；
• Data Flow（數據流圖）：數據管道、血緣、敏感數據邊界；
• Lifecycle（生命週期圖）：狀態、重試、等待和終態。

另有兩個進階能力：架構對比（比較改動前後兩份架構快照，用於設計或代碼評審）和帶源碼證據的架構圖（節點可以關聯到某次提交裏的具體文件和行號，需明確要求才啟用）。

生成的頁面自帶一組快捷鍵：/ 查找節點、R 探查路徑、F 進入演示模式、S 切換風格、T 切換主題、E 打開導出。

怎麼安裝

README 的安裝命令：

bash
npx skills add tt-a1i/archify -g

給 Cursor 做明確的非交互安裝：

bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

不安裝先試用：npx skills use tt-a1i/archify@archify --agent codex。

README 列出的安裝位置：Claude Code 在 ~/.claude/skills/ 或項目的 .claude/skills/；Codex CLI 在 ~/.agents/skills/ 或 .agents/skills/（與 Codex 官方文檔一致）；OpenCode 在 ~/.config/opencode/skills/ 等目錄。這三者都能使用完整的渲染和校驗流程。

claude.ai：在 Settings → Capabilities → Skills 上載 archify.zip，README 註明能否完整運行取決於沙箱裏是否有 Node.js。

怎麼用

不需要代碼庫，直接描述就能畫：

text
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.

想讓它基於真實代碼，打開倉庫後這樣說（README 的示例）：

text
Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.

這段提示裏有幾個值得照搬的做法：限定組件數量、指定一條主路徑、把次要資訊放進卡片而不是多畫連線。出圖後在對話裏繼續提小修改即可。拿不準用哪種圖，可以運行 node archify/bin/archify.mjs guide "Show an API request with Redis cache miss" 讓它給建議。

頁面文字預設支持英文和簡體中文兩種介面語言，在源文件的 meta.locale 裏設定。

適合誰 / 不適合誰

適合：

• 接手陌生代碼庫、想先得到一張全局圖的開發者；
• 寫技術方案、做設計評審或分享，需要一張能點開講的圖的人；
• 想把學習路線、行程、流程這類非技術內容做成可交互頁面的用戶。

不適合：

• 需要所見即所得、手動拖拽編輯的場景——README 明確說這不在範圍內；
• 想把已有 Mermaid 圖自動轉換過來的人——同樣不支持；
• 把圖當作事實依據的場合——圖反映的是智能體對代碼的理解，README 也強調交互功能不推斷真實的運行影響或風險。

注意事項

• 許可證：倉庫 LICENSE 為 MIT（文件中列有 Archify 作者與上游項目 Cocoon AI 兩條版權聲明）。
• 維護狀態：更新活躍，最近一次推送 2026-10-10。
• 安全提醒：技能自帶 Node.js 腳本，會在本機執行校驗和渲染、寫出 HTML 文件；可選的預覽模式會在本機迴環地址上開一個臨時端口。README 說明它可能會聯網請求一個固定的版本清單，僅用於提示有新版本，不會自動下載或安裝更新，也不上載項目數據、提示詞或裝置標識；設定環境變量 ARCHIFY_UPDATE_CHECK_DISABLED=1 可以關掉。和其他第三方技能一樣，安裝前通讀 SKILL.md 與腳本。
• 認準官方渠道：README 特別說明項目本身免費開源，官方渠道只有 GitHub 倉庫和 archify.si；名稱或域名相似的第三方在線服務及其收費方案不代表項目方。
• 兼容性：完整流程需要 Node.js（社區集成部分要求 18 及以上）；claude.ai 上載方式和 Project Knowledge 方式功能有限。
• 分享帶源碼證據的圖之前，確認其中的文件路徑和代碼片段可以公開。