---

name: ci-failure-triage
description: CodexやClaude CodeでGitHub ActionsなどのCIが失敗したとき、最初の意味のある失敗を特定し、環境差・依存・テスト・lint・buildを切り分けて最小修正するスキル。CI修正やPRの赤いチェック対応で使う。

CI Failure Triage

目的

大量のログに引きずられて無関係な箇所を変更せず、CI失敗の最初の原因を特定してローカルで再現・修正する。

手順

1. 失敗したworkflow、job、step、実行コマンドを確認する。
2. ログの末尾だけでなく、最初に現れた意味のあるエラーを探す。
3. 同じエラーから連鎖している後続エラーは一旦分離する。
4. workflow定義、package manager、runtime version、OS、環境変数などCI特有の条件を確認する。
5. 可能ならCIと同じコマンドをローカルで再現する。
6. 原因を次のどれかに分類する。
   • コード・テストの失敗
   • lint / format / type check
   • build
   • 依存関係・lockfile
   • runtime / OS差
   • workflow設定
   • flaky test
7. 原因に直接対応する最小修正を行う。
8. 対象コマンドを再実行し、必要なら関連チェックも実行する。

ルール

• CIを通すためだけにテストやチェックを無効化しない。
• version pinやlockfileの意図を確認せず更新しない。
• flakyに見える場合も単純な再実行だけで完了扱いにしない。
• 外部サービス障害などコード外要因なら、修正を捏造せず根拠を示す。

完了報告

失敗step、根本原因、修正内容、再実行した検証を簡潔に示す。