適用情境
- 第一次試 graphify
- 小型專案（< 500 檔）
- 想快速驗證「助理 + 圖譜」搭配效果
⚠️ 與舊版（已刪除）差異：舊工作流誤用了 graphify 不存在的
init與visualize子指令（extract則是真實指令）。新工作流對應 graphify v0.9.32 官方 README「Get started (30 seconds)」。
流程總覽
flowchart LR
A[1. uv tool install graphifyy] --> B[2. graphify install]
B --> C[3. /graphify . - 建圖]
C --> D[4. graphify query - 查詢]步驟 1：安裝 CLI
# uv 推薦（隔離環境、避免污染系統 Python）
uv tool install graphifyy
# 或 pipx
pipx install graphifyy🔑 PyPI 套件名是
graphifyy（雙 y），CLI 指令是graphify。如果graphify找不到，執行uv tool update-shell後再開新 terminal。
驗證：
graphify --version
# 預期輸出版本號 >= theme.yaml 中的 version步驟 2：對你的 AI 助理註冊 graphify
# 進入專案目錄
cd ~/projects/your-app
# 任選一個助理（這裡以 Claude Code 為例）
graphify claude install --project產出：
.claude/skills/graphify/SKILL.md.claude/settings.json加 PreToolUse hook（搜尋前 nudge 助理先 query）
步驟 3：建圖
在 AI 助理中：
/graphify .或在終端：
graphify extract . --code-only # 純 AST，不需 API key等待「Writing graphify-out/...」訊息，產出三個檔：
| 檔 | 用途 |
|---|---|
graphify-out/graph.json |
完整 JSON 圖譜 |
graphify-out/graph.html |
互動視覺化 |
graphify-out/GRAPH_REPORT.md |
god node、community、建議問題 |
步驟 4：查詢
graphify query "認證在哪裡實作？"助理會先讀 GRAPH_REPORT.md，跑 graphify query，再回答你，而不是直接 grep 原始碼。