SuperAPI AI 工具集

github-repo-candidate-quality-gate

编程与开发

查看项目

更新于 10-15 14:30

技能介绍

GitHub Repo Candidate Quality Gate 是一个用于筛选 GitHub 仓库搜索结果的技能。当宽泛的 GitHub 搜索输出过于嘈杂、无法直接用于可合并的建议时,可以使用该技能。

用途

该技能面向已经运行过 gh search repos(或等效搜索)并需要获得可推荐级别保留项的场景。它要求在过滤保留项的同时保留广泛的发现证据,并且需要为无人值守的 cron 审查提供 lane 级状态与降级原因报告。

主要能力

该技能定义了一套确定性的质量门流程,按顺序执行:

  1. 许可证门:丢弃缺失或未知许可证的仓库,除非有明确的例外理由。
  2. 归档门:默认丢弃已归档的仓库。
  3. 新鲜度门:如果 pushed_at 早于 24 个月则丢弃,除非有例外与风险说明。
  4. 适配门:丢弃仅关键词匹配但适配度低的仓库。
  5. 信号门:保留广泛的发现证据,但可推荐级别的保留项需要具备牵引力信号(默认:stars >= 3)或有明确的采用理由。

对于每个保留的候选,必须捕获以下最小元数据:full_name、url、license、pushed_at(或 updated_at 作为回退)、archived、stars、一行适配理由、来源标签。

报告契约

该技能要求:即使保留项很少,也要保留并发布完整的发现计数;输出 lane_status: pass|degraded;使用 license、stale、low-fit、archived、low-signal、no-results 输出 degraded_causes 计数;当某个 lane 在完成文档化恢复后 raw_count == 0 时,显式包含 no-results 以保持降级报告确定性;包含 lane 健康指标:kept_count、raw_count、median_stars_raw、zero_star_raw;说明所使用的来源标签(直接页面检索、索引片段等)。

使用方式

该技能以技能形式提供,具体安装命令与调用方式暂未提供。其工作方式是在已有搜索结果的基础上执行上述质量门与报告契约。

适用场景

适用于需要将宽泛 GitHub 搜索输出转化为可推荐候选列表的场景,尤其是需要保留发现证据、进行确定性过滤、并为自动化审查提供 lane 级状态与降级原因报告的情况。

限制

该技能不删除原始证据文件;如果更严格的门导致保留数过少,则保留输出并标记 lane 降级;例外保留仅在理由与风险说明明确时允许。关于收费、价格、平台支持等具体信息暂未提供。