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件で、ゼロスターのリポジトリが多数あります。
• 出力：探索結果を保持し、メタデータ／鮮度／シグナルの各ゲートで推奨候補を絞り込み、確認者向けに劣化原因を記録します。