generate-tech-stack 是做什麼的?
掃描當前專案並生成一份完整的視覺化技術棧頁面。
步驟
-
找到專案根目錄 — 使用當前工作目錄,除非使用者指定了路徑。
-
執行分析器:
python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.html -
開啟輸出的檔案:
xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || true -
向使用者報告 — 包括:
- 偵測到的工具數量與找到的分類數量
- 輸出檔案的可點擊連結
- 從腳本標準輸出取得的每個分類的單行摘要
輸出格式
生成的 HTML 必須包含以下所有區段(腳本會自動產生全部):
- 統計行 — 大型數字方塊:工具總數 · 分類數 · AI 後端(如果有) · 資料儲存
- 架構圖 — 分層流程:
- 第 1 行:你的應用程式 / LLM 應用程式(紫色框)
- 第 2 行:網路/API 框架(綠色框,副標題為 auth/middleware)
- 第 3 行:AI SDK 方塊並列(藍色,每個後端一個 — 僅在偵測到 AI SDK 時顯示)
- 第 4 行:資料庫方塊 + 可觀測性 + 前端(暗色行)
- 長條圖摘要 — 水平長條,每個分類一條,顏色對應
- 工具卡片網格 — 每個分類一張卡片,包含:
- 彩色圖示方塊 + 分類標題 + 工具數量(在標題區)
- 每個工具:顏色圓點 · 名稱 · 描述 · 徽章藥丸
- 頁尾 — 專案名稱 · 工具數量 · 生成日期
設計標記(深色模式)
| CSS 變數 | 值 | 用途 |
|---|---|---|
--bg | #0f172a | 頁面背景 |
--bg2 | #111827 | 次要背景 |
--bg3 | #161e2e | 卡片 / 圖表背景 |
--bg4 | #1a2535 | 浮動表面 |
--border | #1e293b | 卡片 / 區塊邊框 |
--border2 | #263347 | 懸停邊框 |
--text | #f1f5f9 | 主要文字 |
--muted | #64748b | 次要 / 標籤文字 |
--dim | #334155 | 頁尾 / 分隔線文字 |
--green | #22c55e | 強調色(徽章圓點、統計高亮) |
--mono | 'JetBrains Mono', monospace | 程式碼 / 徽章字型 |
--sans | 'IBM Plex Sans', system-ui, sans-serif | 內文字型 |
字型從 Google Fonts 載入:
IBM Plex Sans:wght@300;400;500;600;700
JetBrains Mono:wght@400;500;600
標題 h1:color:#f8fafc,無漸層。長條圖軌道:background:#0a0f1a。
備用方案(腳本未找到)
如果找不到 ~/.claude/skills/generate-tech-stack/scripts/analyze.py:
- 讀取
requirements.txt、package.json、go.mod、Cargo.toml、pyproject.toml - 檢查是否存在
Dockerfile、docker-compose.yml、.github/workflows/、alembic.ini - 識別每個工具的分類與用途
- 使用上述設計標記與區塊結構撰寫
TECH_STACK.html
注意事項
- 總是覆蓋現有的
TECH_STACK.html— 無需詢問確認 - 適用於 Python、Node.js、Go、Rust、Java、Ruby、PHP 專案
- 架構圖會根據偵測結果動態調整:如果某個分類為空,則該層會被省略