github-repo-candidate-quality-gate

GitHub 仓库候选项质量门槛

当宽泛的 GitHub 搜索结果过于嘈杂，无法直接用于可合并的推荐时，请使用此技能。

适用场景

• 你已经运行了 gh search repos（或等效命令），需要筛选出达到推荐标准的候选项。
• 你必须保留宽泛搜索的发现证据，同时以确定性方式筛选保留项。
• 你需要按类别报告状态和降级原因，以便无人值守的 cron 审查。

保留项所需的最低元数据

对每个保留的候选项，记录所有字段：

• full_name
• url
• license
• pushed_at（或在缺少时使用 updated_at）
• archived
• stars
• 一句话说明其适配理由
• 来源标签

质量门槛顺序

1. 许可证门槛：除非有明确的例外理由，否则剔除许可证缺失或未知的仓库。
2. 归档门槛：默认剔除已归档的仓库。
3. 新鲜度门槛：除非注明例外及风险，否则剔除 pushed_at 距今超过 24 个月的仓库。
4. 适配度门槛：剔除仅关键词匹配但适配度低的仓库。
5. 信号门槛：保留宽泛搜索的发现证据，但达到推荐标准的保留项必须具备关注度（默认：stars >= 3），或有明确的采用情况说明。

报告约定

• 即使保留项很少，也要保留并发布完整的发现数量。
• 输出 lane_status: pass|degraded。
• 使用以下类别统计输出 degraded_causes：license、stale、low-fit、archived、low-signal、no-results。
• 如果在记录的恢复操作后某个类别最终 raw_count == 0，请明确包含 no-results，以确保降级报告具有确定性。
• 包含类别健康指标：kept_count、raw_count、median_stars_raw、zero_star_raw。
• 说明所使用的来源标签（如 direct page retrieval、indexed snippet 等）。

支持回滚的操作

• 绝不删除原始证据文件。
• 如果更严格的门槛导致保留项数量过少，则保留输出，但将类别标记为降级。
• 仅当明确说明理由和风险时，才允许保留例外项。

示例

• 输入：30 条原始结果，其中许多仓库的星标数为 0。
• 输出：保留发现证据；通过元数据、新鲜度和信号门槛筛选达到推荐标准的保留项，并记录降级原因，供审核者查看。