name: handle-ci-failure description: CI (GitHub Actions) の失敗を検知・分析し、LinearのIssueとして登録します model: opus
CIの失敗を調査し、永続化(チケット化)します。
手順
-
ステータス確認:
gh run list --limit 1 --json conclusion,workflowName,urlで直近の状況を確認。conclusionがfailureでなければ、「CIは成功しています」と報告して終了。
-
ログ分析:
gh run view --log-failedでエラーログを取得。- エラーの根本原因を特定する(Lint / Test / Build / Security)。
- 必要に応じて
catで関連コードを確認。
-
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
- Title:
- 以下の内容でLinearチケットを作成することをユーザーに提案(またはMCPで作成):
-
次のアクション提案:
- チケット作成後、ユーザーに以下を提案:
- 「このまま修正作業(
fix)に入りますか?」 - 「それとも一旦チケット化だけして終了しますか?」
- 「このまま修正作業(
- チケット作成後、ユーザーに以下を提案:
使いどころ
- CI失敗の通知が来た後に呼び出す。
review-flowの前に、ビルドが通っているか確認するために呼び出す。