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 速率限制。建议使用者定义分析范围（如快速概览或深度依赖扫描），以优化执行时间与资源使用。