AIコーディングエージェントにIssueから修正を任せる方法｜バックグラウンド実行とレビューの流れ

AIコーディングツールには、エディタの中で補完や対話をする使い方のほかに、Issueや依頼文を渡すと、クラウド上の作業環境でコードを変更し、プルリクエストまで作る使い方があります。担当者が手元で付きっきりにならずに済む一方で、「どの課題を任せてよいのか」「出てきた変更をどう確かめるのか」で迷うこともあります。

Issueから修正を任せるときは、任せる課題を絞り、作業環境の権限を制限し、出てきたプルリクエストを人の変更と同じ手順でレビューすることが大切です。この記事では、課題の選び方、Issueの書き方、作業環境の制限、レビューと失敗時の戻し方を説明します。

バックグラウンドで動くコーディングエージェントの仕組み

この使い方では、利用者がIssueや依頼文でタスクを渡すと、エージェントがクラウド上の作業環境にリポジトリを用意し、コードの調査、変更、テストの実行を進めます。作業が終わると、変更をブランチに入れてプルリクエストを作るか、利用者がプルリクエストの作成を指示します。

主なツールでは、次のような形で提供されています。

機能の名前や開始の方法は更新が続いています。導入するときは、各社の公式ドキュメントで最新の手順と、利用できるプランを確認してください。

任せる課題の選び方

最初に任せる課題は、変更の範囲が小さく、正しく直ったかを人が短時間で確かめられるものにします。

判断に迷う課題は、エージェントに「変更せずに原因の候補と変更が必要なファイルを調べて報告して」と依頼する方法があります。報告を読んでから、修正まで任せるかを決めます。

Issueの書き方

エージェントは、Issueに書かれた内容とリポジトリの中の情報から作業を進めます。人なら口頭で補える前提も、Issueに書いておく必要があります。

現象: 注文一覧画面で、注文日の並び順が古い順になっている。
再現手順: 管理者でログインし、注文一覧を開く。
期待する結果: 初期表示で注文日の新しい順に並ぶ。
変更してよい範囲: 注文一覧の取得処理と、その処理のテスト。
変更しないもの: データベースの定義、他の一覧画面。
完了条件: 既存のテストがすべて通り、並び順を確かめるテストが追加されている。

「変更しないもの」と「完了条件」を書いておくと、エージェントが範囲外のファイルまで変更するのを防ぎやすくなります。テストの実行方法やコードの書き方のように毎回共通する前提は、リポジトリにAI向けの指示書を置くときの書き方で説明した指示書にまとめておきます。

作業環境で制限すること

バックグラウンドで動くエージェントは、人が操作を一つずつ確認しないまま作業を進めます。そのため、作業環境の権限を先に絞っておきます。

確認したいのは、エージェントが触れるリポジトリの範囲、作業環境に渡す秘密情報、外部への通信を許す接続先、ブランチへの書き込みの範囲です。本番環境の認証情報は作業環境に渡さず、テストに必要な値は架空のものを使います。秘密情報の扱いは、AIコーディングで気をつけたい秘密情報の扱いも参照してください。

メインのブランチにはブランチ保護を設定し、エージェントのプルリクエストもレビューの承認とテストの通過がなければ取り込めないようにします。エージェントが動く環境ごとの設定項目は、ツールの公式ドキュメントで確認してください。

注文一覧の並び順を直す想定例

ここからは想定例です。開発リーダーが、先ほどのIssueをコーディングエージェントに任せます。リーダーはIssueをエージェントに割り当て、作業が終わるまで別のレビューを進めます。

エージェントは注文一覧の取得処理を調べ、並び順の指定を変更し、並び順を確かめるテストを追加したプルリクエストを作ります。リーダーは、プルリクエストの説明とセッションの記録を読み、エージェントがどのファイルを調べ、どのテストを実行したかを確かめます。

差分を見ると、注文一覧の取得処理のほかに、共通の日付表示の関数も変更されていたとします。この関数は、Issueの「変更しないもの」に書いていなかった箇所です。リーダーはプルリクエストにコメントで「日付表示の関数は他の画面でも使うため変更を戻し、並び順の修正だけにしてください」と依頼し、修正後の差分を再び確かめます。

プルリクエストのレビュー

エージェントが作ったプルリクエストも、人が作った変更と同じ基準でレビューします。見る順番は、Issueの完了条件と変更内容の照合、変更範囲、テストの中身と結果、秘密情報や権限の扱いです。詳しい手順はAIが書いたコードのレビュー手順にまとめています。

エージェントの変更で特に確かめたいのは、Issueに書いていない変更が含まれていないか、テストを通すためにテストの期待値を書き換えていないかの二点です。レビューのコメントは、場所、条件、期待する結果を具体的に書くと、エージェントが修正しやすくなります。

失敗したときの戻し方

エージェントの作業が期待と合わないときは、次の順番で戻します。

1. 取り込む前なら、プルリクエストを閉じ、作業用のブランチを削除する
2. Issueの記述が足りなかった点を書き足し、範囲を狭めてもう一度依頼する
3. 同じ課題で二度続けて合わない場合は、人が担当する課題に切り替える
4. 取り込んだ後に問題が見つかったら、取り込みを打ち消すコミットで元に戻す

失敗した依頼とその理由を記録しておくと、任せる課題の基準を見直すときの材料になります。予定外の動作が起きたときに作業を止める条件は、AIコーディングツールをチームで使うための運用ルールで整理しています。

まとめ

Issueから修正を任せるときは、再現手順と完了条件を書ける小さな課題から始めます。作業環境では触れる範囲、秘密情報、外部への通信、ブランチへの書き込みを制限します。出てきたプルリクエストは人の変更と同じ手順でレビューし、合わなければ閉じてIssueを書き直してください。

e-GrantsのAI開発環境の導入・整備では、Codex・Claude Code・GitHub Copilotの導入を支援し、チームの開発の進め方に合わせて設定と運用ルールを整えます。Issueから任せる運用をどの課題から試すか、一緒に整理することもできます。一宮市・名古屋市・愛知県を中心に、オンラインで全国からご相談いただけます。