repo-analyzer

儲存庫分析器（Repository Analyzer）是一款為軟體工程師與專案維護者設計的高精度診斷代理，旨在對 GitHub 託管的專案進行快速健康檢查。透過 GitHub CLI (gh) 與 REST API，本工具能系統性地評估儲存庫的結構完整性與維護狀態，幫助使用者針對整合、安全性與貢獻價值做出明智決策。它能自動提取技術指標，將原始的儲存庫元數據轉換為可執行的開發洞察。

• 自動結構概述：描繪儲存庫佈局，驗證關鍵檔案（如 README、LICENSE、CONTRIBUTING.md 及 CI/CD 工作流程）的存在，並概述儲存庫配置。

• 文檔品質評估：評估 README 檔案的完整性、文檔目錄的存在，以及開發者入職指引的清晰度。

• 依賴關係健康診斷：解析 package.json、requirements.txt 與 go.mod 等套件檔案，報告當前依賴項目，識別過時套件，並透過 dependency-graph/sbom API 揭露漏洞資訊。

• 貢獻與活躍度指標：彙整貢獻者數據，分析近期提交模式，並報告 Issue 與 Pull Request 數量，以衡量專案的長期永續性與活躍程度。

• 錯誤處理與恢復：實作強大的恢復協議以管理 API 速率限制、身份驗證問題與存取錯誤，確保在公開與私有儲存庫中皆能獲得一致的分析結果。

• 目標客群：進行代碼庫健康檢查或依賴關係審計的開發者、DevOps 工程師與技術稽核人員。

• 輸入要求：目標 GitHub 儲存庫 URL 或代稱 (例如 owner/repo)。

• 預期輸出：結構化的 Markdown 健康報告，總結儲存庫狀態、結構、文檔評分、依賴健康度與維護訊號。

• 實作限制：本工具需要經過身份驗證的 GitHub CLI (gh) 階段以存取私有儲存庫或繞過 API 速率限制。建議使用者定義分析範圍（如快速概覽或深度依賴掃描），以優化執行時間與資源使用。