SuperAPI AI 工具集

repo-eval

通用与其它

查看项目

更新于 10-16 01:14

技能介绍

用途:评估公开 GitHub 仓库的动量(人气轨迹)与维护健康度,回答仓库是否健康、增长、衰退或被弃置。两个维度相互独立,可组合出“流行但被弃置”或“小众但维护精良”等结论,需结合阅读。

主要能力:动量数据来自 OSS Insight API(无需认证),包括 star 历史、issue/PR 创建者历史、组织分布。维护数据来自已认证的 gh CLI,包括首次响应时间、合并时间、PR 接受率、issue 半衰期、开放 PR 积压时长、发布节奏、自合并率、贡献者集中度、CI。指标按月计算,窗口至少 12 个月(--months,默认 18),并拟合斜率,因此趋势而非当前水平决定结论。脚本始终打印原始指标与分数并列,结论可审计。

使用方式:先确认 gh auth status 已登录,且 OSS Insight 可访问。运行 python3 scripts/repo_eval.py OWNER/REPO 进行完整评估;可用 --momentum-only 或 --maintenance-only 单轴评估;--json 输出机器可读结果(含 maintenance.monthly 逐月趋势);--months 24 扩大窗口;--period week 对年轻仓库使用周粒度 star;--selftest 离线验证指标计算。若某一轴不可达会降级并显示 Incomplete。

适用场景:判断开源项目是否值得依赖或贡献,识别成熟与衰退项目,审计维护趋势。

限制:零第三方依赖,仅标准库与 gh CLI。机器人账号在统计前被过滤。star/贡献者总数只增不减,因此技能使用速率与趋势而非总量。超活跃仓库的 issue/PR 分页上限可能缩短实际趋势窗口,报告会打印 *_span_months 并加 ! 提示,受影响趋势返回 null。SaaS-OSS 的高贡献者集中度属预期,仅作为风险报告而非重罚。许可证维度不在范围内,需单独检查。具体评分阈值与指标定义见 REFERENCE.md。