heyeddi-ci-fails について
プルリクエスト作業向けのローカルエージェントスキルです。失敗した Checks を取得し、ログに基づいて診断・修正し、根拠のあるコマンドで検証します。修正はコミットしてプッシュしますが、マージには承認が必要です。
主な機能
- 01失敗した Checks の取得
- 02ログに基づく診断レポート
- 03対応可能な失敗の修正
- 04根拠のあるコマンドで検証
- 05修正をコミット・プッシュ
活用シーン
- 01PR の CI チェック失敗を調査
- 02ログで確認できる失敗を修正
- 03修正を検証して PR ブランチへプッシュ
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ heyeddi-com/ heyeddi-ci-skills --skill heyeddi-ci-failsインストール後、Claude Code で/heyeddi-ci-failsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
manifest.jsoncontext/ANTI_PATTERNS.mdEXAMPLES.mdPROSE_ANTI_SLOP.mdVOCABULARY.mdscripts/_skill_cli.pyassert_no_merge.pydiscover_and_verify.pyfetch_failing_checks.pywrite_ci_fails_report.py詳細
HeyEddi CI の失敗
App の /heyeddi fails に対応するローカルエージェント版です。失敗している Checks を取得して診断レポートを作成し、対処可能な失敗を修正して、根拠となるコマンドで検証します。スタックに依存しません(ログ駆動)。
デフォルトの動作(確認不要)
PR に関するすべての作業(オープン中の PR、PR ブランチ、レビュー依頼、@heyeddi-pr-respond の実行前)で、このスキルを自動的に実行します。CI に触れたり、失敗の修正を依頼されたりするまで待たないでください。
- 失敗している Checks を必ず取得して診断します
- 診断で対処可能な失敗が特定された場合は、必ず修正を適用します
- PR ワークフローの一環として、修正を必ずコミットしてプッシュします
- マージにのみ、現在のターンでのマージの許可が必要です
一時的なアーティファクト(コミットしないでください)
| ファイル | 役割 |
|---|---|
pr-<N>-ci-fails-raw.json | 生の gh 証拠 |
pr-<N>-ci-fails.md | 診断レポート |
これらは決してコミットしないでください。GitHub Checks を SSOT とします。
パイプライン
fetch_failing_checks --pr <N>
write_ci_fails_report --pr <N> --force
→ fill likely cause / proposed fix from logs
apply fixes when diagnosis identifies actionable failures (default — do not ask)
discover_and_verify [--run]
assert_no_merge --check
→ commit + push to PR branch when fixes applied
ホスト型 App による分析を利用する場合(該当する経路では課金されます)、PR に /heyeddi fails とコメントできることもユーザーに伝えてください。
厳守事項
- Check の証拠を示さずに失敗原因をでっち上げないでください
- マージの許可なしにマージしないでください
- Check または Spot の証拠なしに、Spot/GHA ジョブが実行されたと主張しないでください
ツール
| ツール | 目的 |
|---|---|
fetch_failing_checks | 失敗している Checks の読み取り専用集約 |
write_ci_fails_report | pr-<N>-ci-fails.md を書き込む |
discover_and_verify | 修正後に根拠を示して検証する |
assert_no_merge | マージのハードゲート |
完了時
python .agents/skills/heyeddi/scripts/suggest_next_skill.py \
--current-skill heyeddi-ci-fails --project-root .
コメント
Markdown 対応