---
title: "CircleCIでコーディングエージェントにCIエラーの修正指示を出す"
date: 2026-01-08
categories: "CircleCI"
url: "https://hidetaka.dev/ja/writing/dev-notes/analyze-a-root-cause-of-ci-failure-with-circleci"
---

AIコーディングにおいて、自動テストやCIサービスによる品質チェックは欠かすことのできない要件です。実行するたびに生成結果が変わる生成AIには、意図しない設計や実装・変更などが紛れ込むリスクがあり、それを回避するための安全装置・ガードレールともいえます。

この記事では、さらに一歩進んで、「CIで検知したエラーの修正を効率的に行う」方法について紹介します。

## CIの失敗をコーディングエージェントに伝える方法

AIコーディングでは、原則として変更を Pull Request形式で受け取ります。エディタやCLIであればプロダクションブランチに直接コミットすることが可能ですが、DevinやClaude Code on the Web / Cursor Cloud Agentsなどを使う場合は Pull Request一択です。

そしてCircleCI / GitHub Actionsなどで CI パイプラインを構築していると、テストやビルドなどが Fail していることが少なくありません。時には彼らのローカル環境では成功するのに、CIではfailする・・・というパターンすら見かけることがあります。

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/9b6ab416e9b8597b09400cef7471448c-20260103112304.png?&d=1140)

CIが Fail した場合に取れる手段はいくつかあります。１つは「Failしたコマンドを実行し、エラーを修正しろ」とエージェントに指示する方法です。シンプルなプロンプトで指示できるため、多くの方が選んでいるのではないかと思います。ただ、テストやビルドを実行してログを読んで・・・となるため、どうしてもコンテキストウィンドウが圧迫されやすいという問題が発生します。となると次に選ぶことになるのは「エラーログをエージェントに提示する」方法です。これはGitHub Actions / CircleCIなどに出力されたエラー結果をコピーしてエージェントに提示する方法です。これによってエージェントは「どんな問題がどのコマンドで起きているか」を把握した上で作業に取り掛かれます。しかしこちらもテストやビルドが出力するログが多くなると、コンテキストウィンドウを圧迫する問題が再度発生します。

CircleCIを使っている場合、もう１つの選択肢が選べます。それは「CircleCIが失敗原因を調査した結果を共有する」方法です。

## CircleCIは失敗したジョブの分析レポートを作れる

CircleCIには「何が問題でCIのジョブが」コケているかをCircleCI自身が調査してくれる機能があります。失敗したジョブには「**Explain this error**」ボタンが表示されていますので、これをクリックしましょう。するとCircleCIが持つAIエージェントが調査とレポート作成を開始してくれます。

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/8a54fae8f74a88e3e3f3635ae437573f-20260103112304.png?&d=1140)

調査結果はウィンドウの右側にパネルとして表示されます。スマートフォンが考慮されていない様子なので、2026/01時点ではPCから試すことをお勧めします。iPhone Pro Maxでも厳しかったので・・・

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/38aba34cb85115d84a34c67d3bd05d62-20260103112304.png?&d=1140)

レポートが生成されたら、これをコーディングエージェントに共有しましょう。

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/8fe882bfc5b14ccd5b74f33a7d067316-20260103112304.png?&d=1140)

今回は Kiro に修正を指示しました。チャットの履歴を読むと、レポートに書かれているファイルの修正作業から着手していることがわかります。「何をやるべきなのか」がまとめられたレポートを渡すことで、コーディングエージェントが修正作業へ迅速に取り組むことができるようになりました。

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/c51049f42f7a1e48448ffd3ebe7a8242-20260103112346.png?&d=1140)

コードの修正が終わったの血、最後にビルドやテストを実施して問題が解消したことをレポートしてくれています。

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/412950d9e5a72ac3f9e6c361e7964743-20260103112649.png?&d=1140)

この変更を commit / pushすると、次のCIパイプラインでは全てのジョブが成功していました。

![](https://wp-kyoto.cdn.rabify.me/wp-content/uploads/2026/01/9fac8edbc7563d34c175766925842d00-20260103113951.png?&d=1140)

## まとめ

このレポート機能は無料で利用できます。今回のようにコーディングエージェントに共有して修正作業へ進ませるのも良いですし、社内で該当機能の開発を担当しているメンバーにSlackなどで共有するのも一つでしょう。2026/01時点では英語でのみレポートを作れる状態ですが、翻訳ツールで内容を理解できるようなレポートですので、そこまで読むのが大変ということもありませんでした。

このようにCIサービスの機能をうまく組み合わせることで、「AIが意図せずアプリを破壊した・・・」のようなトラブルを抑止しつつ、出先でのちょっとした機能開発指示やアイディアのプロトタイピングなどを素早く取り組めるようになります。