Communitygithub.com

generate-tech-stack

掃描當前專案並生成一份完整的技術棧視覺化頁面。

generate-tech-stack 是什麼?

這是一個 AI 代理技能,旨在自動掃描當前開發專案,並生成一份視覺化、互動式的技術棧 HTML 頁面。開發者無需手動整理專案依賴,只需執行此技能,即可獲得包含架構圖、圖表、工具卡片等豐富資訊的完整報告。此技能支援 Python、Node.js、Go、Rust、Java、Ruby、PHP 等多種語言生態系,並可透過分析常見的專案設定檔(如 package.json、pyproject.toml)自動識別工具。此技能相容於 Claude Code 等支援 SKILL.md 機制的 AI 代理平台,使用時需確保分析腳本檔案存在。若腳本缺失,則會執行基於規則的備用掃描。生成的 HTML 頁面採用深色模式設計,包含統計行、架構圖、條形圖摘要和工具卡片網格,讓整個技術棧一目瞭然。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add askuma/generate-tech-stack

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

generate-tech-stack 是做什麼的?

掃描當前專案並生成一份完整的視覺化技術棧頁面。

步驟

  1. 找到專案根目錄 — 使用當前工作目錄,除非使用者指定了路徑。

  2. 執行分析器:

    python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.html
    
  3. 開啟輸出的檔案:

    xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || true
    
  4. 向使用者報告 — 包括:

    • 偵測到的工具數量與找到的分類數量
    • 輸出檔案的可點擊連結
    • 從腳本標準輸出取得的每個分類的單行摘要

輸出格式

生成的 HTML 必須包含以下所有區段(腳本會自動產生全部):

  1. 統計行 — 大型數字方塊:工具總數 · 分類數 · AI 後端(如果有) · 資料儲存
  2. 架構圖 — 分層流程:
    • 第 1 行:你的應用程式 / LLM 應用程式(紫色框)
    • 第 2 行:網路/API 框架(綠色框,副標題為 auth/middleware)
    • 第 3 行:AI SDK 方塊並列(藍色,每個後端一個 — 僅在偵測到 AI SDK 時顯示)
    • 第 4 行:資料庫方塊 + 可觀測性 + 前端(暗色行)
  3. 長條圖摘要 — 水平長條,每個分類一條,顏色對應
  4. 工具卡片網格 — 每個分類一張卡片,包含:
    • 彩色圖示方塊 + 分類標題 + 工具數量(在標題區)
    • 每個工具:顏色圓點 · 名稱 · 描述 · 徽章藥丸
  5. 頁尾 — 專案名稱 · 工具數量 · 生成日期

設計標記(深色模式)

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 專案
  • 架構圖會根據偵測結果動態調整:如果某個分類為空,則該層會被省略

相關技能