# Handle CI Failure

> CI (GitHub Actions) の失敗を検知・分析し、LinearのIssueとして登録します

- Skill: `majiayu000/handle-ci-failure` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/handle-ci-failure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/handle-ci-failure/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/handle-ci-failure

---


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` の前に、ビルドが通っているか確認するために呼び出す。