CIのコーディングエージェント: 外部からのプルリクエストは所有者の指示ではない
CIの信頼できない入力、ワークフローの文脈、実行権限と、実行承認とマージ承認の違いを確認します。
記事の言語: 日本語

目次
提出された変更の名前は「ドキュメントの小さな修正」だ。説明欄で、作成者は変更を確認する前にエージェントが環境を準備する方法を記している。自動処理はコマンドを実行し、テストを走らせ、整った要約を返す。問題はその前に起きていた。会社の環境を管理すべきでない人が、その環境の操作手順を書いていたのだ。
架空のカタログサイトを開発するチームが、外部の人からプルリクエストを受け取る。プロジェクトに取り込む特定の変更一式の提案だ。エージェントはその評価を支援し、CI、つまり継続的インテグレーションは自動チェックを実行する。両者を組み合わせるには、外部の内容を分析資料として扱い続けるのか、実行を指示できるようにするのかを決めなければならない。
対象は変更されたファイルだけではない。タイトル、説明、ブランチ名、コメント、過去のチェック結果も自動処理のコンテキストに入りうる。それぞれの出所を識別できる必要がある。GitHubや別の社内ツールが欄を表示しているというだけで、その内容の作成者があなたたちのタスクの所有者になるわけではない。
まず、それぞれを誰が管理できるか確かめる
このサイトでは、プロジェクトの管理者がレビュー範囲を定める。提出者は提案したコードと自分の説明を管理する。チームはワークフロー、つまり自動化の各段階の定義とアクセス設定を維持する。エージェントは与えられたツールを使って資料を処理する。すべての情報が一つのプルリクエスト画面に見えても、これは四つの異なる役割だ。
プロセスへの入力を一覧にしよう。各欄の作成者、取得方法、次の用途を示す。説明はモデルへの指示文に、タイトルは命名チェックのスクリプトに、ファイル内容はテストに渡るかもしれない。「プルリクエストを読むだけ」という言葉で評価を終えてはいけない。内容を表示することと、実行のために渡すことは区別する必要がある。
GitHubは信頼できない欄をコードとして解釈する危険性を説明し、タイトル、説明、ブランチ名などを例に挙げている。内容を実行スクリプトに挿入すると、その結果が変わることがある。
エージェントには自然言語の解釈という別の問題が加わる。説明の中に、範囲の拡大、チェックの省略、別のリソースの読み取りを指示する文があるかもしれない。モデルはその内容を報告できる一方、プロジェクト管理者からの指示とは扱わない必要がある。修正を提案する権利には、あなたたちの環境の規則を変える権限までは含まれない。
ただし、命令形の文がすべて攻撃とは限らない。ドキュメントにプログラムのインストール手順があり、それを評価することがタスクの場合もある。エージェントは合意した範囲で手順を読み、妥当性を確認できるべきだ。実行は別の判断である。プロジェクトを説明するREADME内の指示をすべて機械的に拒否すれば、通常のドキュメントレビューを妨げる。
製品がエージェントの作業規則を読み込むファイルにも、別途注意が必要だ。その実行では承認済みのベースから取得するのか、提案された変更から取得するのかを確認する。提出者はサイトのコードだけでなく、評価方法まで変えようとするかもしれない。入力の記録では、所有者の指示と評価対象に含まれる指示を区別したい。どの製品も同じ方法でこうしたファイルを読み込むと決めつけてはいけない。
コーディングアシスタントのファイル除外規則 (ポーランド語)は、この問題を自動的に解決しない。ファイルを分析のため正当に読めることと、その内容がエージェントの権限を指図してよいことは別だ。CIでは、誰が内容を提供し、どのプロセスで使われるかも明らかにする。
コードの読み取りとプロジェクトの実行は二つの段階
外部の人がボタンの説明を直すとする。エージェントは差分を開き、その後、依存関係をインストールしてテストを実行したくなる。この二番目の段階には、変更した一文よりはるかに多くのものが含まれうる。レビュー担当者は、コマンドが使うスクリプト、設定、その他のファイルがどの版に由来するか示すべきだ。
GitHubのpull_request_targetに関する説明は、コードの取得とその後の実行を区別している。シークレットや高い権限のトークンがある環境で信頼できない内容を実行しないよう警告する。スクリプトや依存関係が行う処理も含まれる。
テストコマンド自体は見慣れたものかもしれない。それでも、評価中のプロジェクトの版で何を実行するか確認する。ワークフロー自体に目立つコマンドを追加しなくても、設定の変更が動作に影響する場合がある。プロセスの所有者がすべてのライブラリーを自分で分析する必要はないが、この段階の評価責任者と環境をどう制限したかは知るべきだ。
この例の最初の判断は、エージェントが提出物を承認済みベースと比較し、コメントを準備することだ。実行する場合は、アクセスを定めた別途準備済みの環境で行う。ツールの名前が「サンドボックス」だからといって、そうした分離が存在するとは仮定しない。エージェントのサンドボックス (ポーランド語)は、ファイル、ネットワーク、認証情報についての実際の境界に基づいて受け入れ確認する。
以前の実行から渡された資料も考慮したい。成果物やエラー記録に、外部の変更に由来する内容が含まれることがある。次の段階がより広いアクセス権で動くなら、自社のCIプラットフォームからダウンロードしたというだけで、成果物全体を信頼できる指示として扱ってはならない。実行をまたいでも内容の出所を保持する必要がある。
環境の準備では、前のタスクから何が残るかも確認する。セルフホスト型ランナー、つまりCIの段階を実行するマシンについては、会社の資源へのアクセスと連続する実行の分離を評価する必要がある。前の実行に置いた架空の確認用ファイルで、次の実行が合意した状態か試せる。一度の実行結果で、同じ作業領域を再利用する際の問題を済ませてはいけない。
チームは、特定の提出物について実行せず分析だけを行うと決めてもよい。その結果は正直に示す。「差分を読んだが、この範囲のテストは実行していない」という報告は、行っていない作業まで含む緑のステータスより多くを伝える。この制限は必ずしも修正の拒否を意味しない。管理された次の段階が必要だと示すこともある。
イベント名だけでは設定全体を説明できない
GitHub Actionsでは、ワークフローを起動するイベントの違いが重要だ。運用上の評価には「テスト実行」ボタンの名前だけでは足りない。自動化の定義、評価するファイルの出所、ジョブに与えられたアクセス権が必要になる。それらの組み合わせが実際の結果を決め、適切な能力を持つ担当者が評価しなければならない。

このイベントのドキュメントは、pull_request_targetが信頼されたベースのコンテキストを使うと説明している。その後で外部のコードを取得して実行すると問題が生じうる。したがって、ベース由来のワークフローファイルが、そのワークフローの実行するすべてのものの出所を証明すると考えてはいけない。
ガイドの設定を、現在の規則を比べずに別のリポジトリへコピーしてもいけない。公開リポジトリ、非公開リポジトリ、独自のポリシーを持つ環境では範囲が異なる場合がある。受け入れ確認では、実際に確認した状態と日付を示す。「安全なレビュー」という独自のプロセス名は、特定の制限を適用した証拠ではない。
完成した製品では、標準の保護と会社の設定も区別する。GitHubはCopilot cloud agentの変更後にワークフローを実行する際、標準では承認が必要だと説明する一方、自動実行も設定できるとしている。標準の動作をすべての導入環境に当てはめてはならない。
これは特定サービスの例であり、すべてのエージェントに共通する規則ではない。Copilot cloud agentのリスクに関するドキュメントは、入力中の外部指示や、自動化が利用できるツールの制限にも触れている。会社の受け入れ確認では、使用製品、モード、付与した機能をなお確認する必要がある。
チェック実行への同意と、変更をマージする同意は別の判断だ。ボタンを押す人は、どちらが行われるか知るべきである。環境が機密性の高い資源へアクセスするジョブを実行できるなら、その影響を実行前のレビューに含める。後からプルリクエストを却下しても、すでに行った操作は取り消されない。
Aeneia Audit
CIにおけるエージェントの入力、実行ファイルの出所、各段階のアクセス権を一緒にたどりましょう。運用レビューは、自動化を維持するチームに必要な証拠を明確にする助けになります。外部の変更を扱うエージェントの境界を定める
試験でも外部資料の作成者を明らかに保つ
最初のシナリオには、別の試験用リポジトリ、架空のデータ、実際のシークレットを持たないツールを使える。所有者は、指定された変更を範囲を広げずに分析することを期待結果に定める。提出物の説明には、タスク外の指示を示す明示的で無害な印を加える。検査では、エージェントがそれを権限付与ではなく内容として扱ったか確かめる。
リスクの見取り図を作るために、他人の有害なコマンドを実行する必要はない。技術チームは範囲に合う試験を設計し、実際の境界を観察する。報告では、モデルが読んだ資料、提案された操作、環境が許可した操作を分ける。文章で丁寧に拒否しても、その前にツールが何を実行したかまでは分からない。
別に、製品の正しい使用手順を含む通常のドキュメント変更も加えよう。命令形があるというだけでエージェントが拒否すれば、制御が普段の作業を妨げる。チームには、手順の説明と、それを実行する権限の出所を区別する方法が必要だ。どちらの場合も外部の提出者が資料の作成者である。
実行環境へ渡すコマンドには、さらにシェルと引用符の解釈 (ポーランド語)という問題がある。シェルはコマンドを解釈するプログラムであり、その意味は別途技術的に評価する必要がある。モデルの文章が管理者の意図に合っていても、スクリプトにデータを代入した後のコマンドの結果は確認できない。
拒否されたケースは、識別できる状態を残すべきだ。運用担当者は、分析、実行、リソースの読み取り、変更の書き込みのどれが停止されたか知る必要がある。エージェントが拒否をタスク完了の障害と呼んだからといって、同じ段階をより高い権限で実行し直してはいけない。アクセスの拡大には、新しい影響に応じた判断が必要だ。
受け入れでは版と実行経路を確認する
記録に、リポジトリ、提出物の版、ワークフローの版、起動イベント、ジョブの主な権限を書こう。試験で実際に実行したファイルの出所も加える。評価後に提出者が、変更を保存した版であるコミットを追加すれば、以前の結果は新しい内容を自動的に説明しない。資料を読んでから実行を承認するまでの間に変更が入る場合は特に重要だ。
架空のサイトで、管理者はボタンの説明だけの変更を見る。その後、提出者がテスト準備スクリプトの修正を追加する。承認ボタンは同じ提出物を対象にしていても、実行する資料は変わっている。実行前に現在の一式を確認し、同意を正しい版に結び付けなければならない。プルリクエスト番号はその結び付けの代わりにならない。レビュー担当者が読んだ版と、ジョブが実際に取得した版を証拠として残そう。
AIによるコードレビュー (ポーランド語)は、実際に読んだ差分を示すべきだ。CIでは実行条件を追加する。プロセスが結び付きを保持しなければ、それらの証拠は異なる版を指すことがある。二つの緑の結果を一つの包括的な承認にまとめるのではなく、報告書で不一致を説明しよう。
最後に、プロセスを引き継ぐ人は、拒否された実行を見つけ、必要な次の段階を言えるべきだ。変更の再読、制限された実行、CI所有者による設定確認などが考えられる。「エージェントがブロックされた」というメッセージだけでは、その判断は決まらない。口頭で補足せず試験用の報告書を渡し、読んだだけの資料とすでに実行されたコードを区別できるか見よう。これは記録の有用性を確かめる実務上の試験であり、他人の保護機構を追加で試すものではない。
責任あるエージェントワークフロー (ポーランド語)の基本は変わらない。タスクの範囲、ツール、結果の証拠は明確でなければならない。CIではさらに、入力の一部を管理する提出者と、段階間の自動的な移行が加わる。プロセスを日常業務で使うと認める前に、これらを考慮する必要がある。
Aeneia Auditでは、この見取り図とAI利用を受け入れるための要件を整理できる。CIセキュリティ自体の専門的なレビューには、適切な範囲と技術的な専門知識が必要だ。結果はサイトの管理者に具体的に答えるものにする。この変更を読み、これらのファイルを定められた環境で実行し、外部の説明には残りのアクセス権を管理する権限を与えていない、という答えだ。









