fix-ci
GitHub Pull Request の失敗している CI を調査し、コードで解決できる問題を修正して commit・push する skill。
SKILL.mdskills/fix-ci/SKILL.md
GitHubFix CI
この skill は明示的に呼び出された場合のみ使用する。
$fix-ci
$fix-ci pr#123
$fix-ci owner/repo#123
- 引数なし: 現在のブランチに対応する PR を対象にする
pr#<number>: 現在の repository の指定 PR を対象にするowner/repo#<number>: 指定 repository の PR を対象にする
この skill の呼び出し自体を、対象 PR に対するコード変更・commit・push の許可として扱う。
Workflow
- 対象 PR を特定する
- 失敗している CI を確認する
- 失敗した job / step のログを確認し、原因を特定する
- コード・テスト・CI 設定で解決すべき問題だけを修正する
- 関連するテスト・型チェック・lint・build を実行する
- Conventional Commits 形式で commit する
- PR のブランチへ push する
- 解決できなかった CI の失敗があれば報告する
原因の確認
CI が失敗していることだけを理由にコードを変更しない。
原因が次のどれに当たるか確認する。
- コード・テスト・CI 設定の問題
- flaky なテストや処理
- repository 外の環境・権限・外部サービスの問題
コード・テスト・CI 設定に原因がある場合は修正する。
repository 外に原因がある場合は、無理にコードを変更せず原因を報告する。
flaky な場合は可能な範囲で根本原因を確認し、単純な retry や sleep だけで隠さない。
修正
修正は、CI の失敗原因を解消するための最小限の変更にする。
- 無関係な箇所は変更しない
- CI を通すためだけに test、型チェック、lint、validation を弱めない
- 既存の設計・命名・テストパターンを優先する
失敗しているテストが正しい仕様を表している場合は、本番コードを修正する。
テスト側が誤っている場合は、根拠を確認したうえでテストを修正する。
検証
修正後は、失敗していた CI に対応する検証をローカルで実行する。
失敗した CI の原因がテスト・型・lint・build に関わる場合は、対応する検証も実行する。
- 関連テスト
- 型チェック
- lint
- build
実行できない検証がある場合は、可能な代替検証を行う。
Commit
commit message は Conventional Commits 形式にする。
<type>(<scope>): <subject>
例は次のとおり。
fix: handle empty response in session lookup
test: remove timing dependency from reconnect test
ci: fix node setup for pnpm cache
複数の CI の失敗が同じ根本原因から発生している場合は、1つの commit にまとめてよい。
Rules
- PR のブランチ以外へ push しない
- 原因を確認せずに修正しない
- repository 外の問題をコード変更で無理に解決しない
- Git の破壊的な操作を避ける
Completion
完了時に以下を短く報告する。
- 特定した原因
- 行った修正
- 実行したテスト・検証
- commit / push の結果
- 解決できなかった CI の失敗