【ITニュース解説】'Fix the Login Bug' Is Anthropic's Own Bad Example. The 6-Field Brief That Replaces It

近年、プログラミング作業を支援するAIコーディングアシスタント、通称AIエージェントの利用が急速に広がっている。しかし、これらの強力なツールを最大限に活用するには、適切な指示の与え方が非常に重要となる。多くの場合、「ログインバグを修正して」といった一見シンプルな指示では、期待する結果が得られず、かえって手間が増えてしまうことがある。これは、AIエージェントがその指示の真意や具体的な作業範囲を理解しきれず、自己判断で作業を進めてしまうためである。

例えば、「ログインバグを修正して」という指示では、AIエージェントはバグが何か、どこに存在するか、どのように修正すべきか、いつ作業が完了したと判断すべきか、といった多くの点を推測に頼ることになる。その結果、修正範囲が想定より広くなったり、余計な変更が含まれたり、期待通りのテストが書かれなかったりする。最終的に、人間側がAIエージェントが出力したコードの変更点（差分）を詳細に確認し、意図しない変更を元に戻したり、不足している部分を追加したりする作業が発生し、効率が落ちてしまうのだ。

このような問題を解決し、AIエージェントとの協業をより効果的にするための方法として、「6つのフィールドからなるブリーフ（指示書）」という考え方が提案されている。これは、AIエージェント開発ベンダー各社が共通して推奨するベストプラクティスを集約したもので、曖昧さを排除し、具体的で構造化された情報をエージェントに提供することを目的としている。このブリーフは、AIエージェントが本来推測するしかなかった「ゴール」「範囲」「制約」などを明確にすることで、より正確で期待通りの結果を導き出す。

それでは、この6つのフィールドそれぞれがどのような役割を果たし、なぜ重要なのかを具体的に見ていこう。

一つ目は「ゴール」である。AIエージェントに何を達成してほしいのか、現状の問題点と修正後の理想的な状態を具体的に記述する。単に「ログインバグを修正して」ではなく、「セッションタイムアウト後に再度ログインしようとすると401エラーが発生する。修正後は、タイムアウトしたユーザーも初回ログインで成功するようにする」といった形で、症状と修正完了時の振る舞いを明確にする。これにより、AIエージェントは達成すべき目標を認識し、いつ作業を終えるべきかの判断基準を得ることができる。

二つ目は「対象ファイル」である。AIエージェントがコードを読み込み、変更すべきファイルやフォルダを具体的に指定する。例えば「src/auth/session.tsとsrc/auth/refresh.tsから作業を始め、新しいテストはtests/auth/に作成する」といった指示がこれにあたる。AIエージェントは指定されたファイルだけを優先的に読み込むため、不要なファイルを読み込むことによる処理コストの増加を防ぎ、修正箇所を限定できる。これは、AIエージェントの処理能力を効率的に使い、作業の的を絞る上で非常に効果的である。

三つ目は「変更範囲外」である。AIエージェントに「触れてはいけない」部分を明確に指示する。例えば「ログインUI、パブリックAPIの形状、package.json、ロックファイルには触れない。変更しないファイルのフォーマット変更もしない」といった制約を設ける。AIエージェントは、指示されていない部分でも「きれいにしよう」として、意図せず変更を加えてしまうことがあるため、これを防ぐ。もし指定外の変更が必要だと判断した場合は、作業を停止して人間に確認を求めるように指示することも重要だ。これにより、後から不必要な変更を元に戻す手間が省ける。

四つ目は「制約」である。AIエージェントが修正作業を進める上で守るべきルールやアプローチを定義する。例えば「修正は最小限に抑える。まず問題再現のための失敗するテストを書き、その後に修正する。新しい依存関係は追加しない。src/auth/refresh.tsにある既存のパターンに従う」といった具体的な指示を与える。単に「良いコードを書いて」という曖昧な指示では、AIエージェントは既に「良いコードを書いている」と認識しているため効果がない。具体的な制約は、AIエージェントがどのように目標を達成すべきかをガイドし、品質と一貫性を保つ手助けとなる。

五つ目は「完了条件」である。AIエージェントが作業を完了したと判断するための具体的な検証ステップを提示する。これは、人間が最終確認を行う前に、AIエージェント自身が自分の修正が成功したかをチェックするための基準となる。例えば「完了とは、npm test -- tests/authが成功し、npm run lintがエラーなく終了すること。これらのコマンドを両方実行し、合格してから完了を報告すること」といった形で、実行可能なコマンドと期待される結果を明示する。これにより、AIエージェントは自身でテストを実行し、問題があれば再試行できるため、人間の検証作業の負担を大幅に軽減できる。これは6つのフィールドの中でも特に重要だとされている。

六つ目は「報告内容」である。AIエージェントが作業完了時に人間に伝えるべき情報を具体的に指定する。例えば「完了したら、根本原因を一行で、変更したファイルを一覧で、実行したコマンドとその結果、そして気づいたが変更しなかった点があればそれを報告すること」といった内容を求める。これにより、人間はAIエージェントが何を実行し、なぜそのように修正したのかを効率的に把握できる。単に「バグを修正しました」という報告よりも、詳細な証拠に基づく報告は、レビュー作業を迅速化し、次のアクションを決定する上で非常に役立つ。

これらの6つのフィールドからなるブリーフは、一度テンプレートを作成してしまえば、「ゴール」と「対象ファイル」の部分だけをタスクごとに書き換えるだけで再利用できる。これにより、指示作成の手間を大幅に削減しつつ、AIエージェントの能力を最大限に引き出すことが可能となる。

ただし、このブリーフはあくまで指示であり、AIエージェントが常にそれに完全に縛られるわけではないという点には注意が必要だ。人間側は最終的に、AIエージェントが作成したコードの変更点を確認し、本当に意図通りの修正が行われたかを検証する責任がある。特に「変更範囲外」の指示が守られているか、変更されたファイルが想定通りかなどは、gitコマンドなどを使って簡単に確認できる。また、すべてのタスクが6つのフィールド全てを必要とするわけではない。タイポ修正のようなごく小さな変更であれば、もっと簡潔な指示でも十分な場合もある。重要なのは、タスクの複雑さに応じて、適切な詳細度で指示を与えることである。

このように、AIエージェントを効果的に活用するためには、明確で構造化されたコミュニケーションが不可欠である。この「6つのフィールドのブリーフ」という考え方は、単にプログラミングの効率を上げるだけでなく、AIとの協業における新しいスタンダードを築くものと言えるだろう。