handle-ci-failure

---

name: handle-ci-failure description: CI (GitHub Actions) の失敗を検知・分析し、LinearのIssueとして登録します model: opus

CIの失敗を調査し、永続化（チケット化）します。

手順

1. ステータス確認:

   • gh run list --limit 1 --json conclusion,workflowName,url で直近の状況を確認。
   • conclusion が failure でなければ、「CIは成功しています」と報告して終了。

2. ログ分析:

   • gh run view --log-failed でエラーログを取得。
   • エラーの根本原因を特定する（Lint / Test / Build / Security）。
   • 必要に応じて cat で関連コードを確認。

3. Linear Issue 起票（提案）:

   • 以下の内容でLinearチケットを作成することをユーザーに提案（またはMCPで作成）:
     • Title: CI Failure: [エラーの概要] (例: CI Failure: Vitest failed in UserAuth)
     • Description:
       • 失敗したWorkflow: [WorkflowName]
       • ログ抜粋: (コードブロック)
       • 推定原因: ...
       • 関連URL: [PR or Run URL]
     • Label: Bug
     • Priority: High

4. 次のアクション提案:

   • チケット作成後、ユーザーに以下を提案：
     • 「このまま修正作業（fix）に入りますか？」
     • 「それとも一旦チケット化だけして終了しますか？」

使いどころ

• CI失敗の通知が来た後に呼び出す。
• review-flow の前に、ビルドが通っているか確認するために呼び出す。