Debug Mode のご紹介: 実行時ログを活用する Agent
コーディング Agent は多くのことが得意ですが、特定のバグについては依然として苦戦することがあります。そこで今回、実行時情報と人間による検証を軸にした、まったく新しい Agent ループである Debug Mode を導入しました。
Debug Mode を構築するにあたり、私たちは社内で最も優れたデバッガーたちの手法を分析しました。そのワークフローを Agent モードに落とし込み、実行時ログでコードを計測するためのツール、何が問題になっているのかについて複数の仮説を生成するプロンプト、そして問題の再現や修正の検証のためにあなたにコールバックできる機能を備えました。
その結果、これまでどれだけ高性能なモデルでも単独では対応が難しかった、あるいは開発者に多くの時間を要していたバグを、確実に修正できるインタラクティブなプロセスが実現しました。
バグの内容を説明する
まずはドロップダウンメニューから Debug Mode を選択し、バグの内容をできるだけ詳しく説明してください。
エージェントは、すぐに修正案を生成しようとするのではなく、まずコードベース全体を読み込み、どこに問題がありそうか複数の仮説を立てます。中には自分でも思いつきそうなものもありますが、一方で、普段なら検討しないようなアプローチも含まれます。
そのうえで、エージェントはそれらの仮説を検証するためのログ出力用のコードを挿入します。これにより、バグが発生したときに実際に何が起きているのかについて、具体的なデータを取得する準備が整います。
バグを再現する
次に、アプリケーションに戻り、エージェントがランタイムログを収集している間にバグを再現します。
バグが発生したとき、エージェントはコード内で何が起きているかを正確に把握できます。変数の状態、実行パス、タイミング情報などです。こうしたデータをもとに、根本原因を特定し、ピンポイントな修正を生成できます。多くの場合、通常のエージェントとのやり取りで返ってくる何百行もの当てずっぽうなコードではなく、2~3行の正確な変更だけで済みます。
修正を検証する
この時点で、Debug Mode は提案された修正を適用した状態でもう一度バグを再現するように求めます。バグが再現しなければ、修正済みとしてマークされ、エージェントはすべてのインストルメンテーションを削除し、すぐにリリースできるクリーンで最小限の変更だけが残ります。
この人間が間に入る検証プロセスは非常に重要です。バグが明らかで簡単な場合もありますが、技術的には動いていても「しっくりこない」グレーゾーンに入ることもあります。その判断をエージェントだけで行うことはできません。バグが直っていないと思う場合は、エージェントがさらにログを追加し、あなたがもう一度再現して、問題が本当に解決するまでアプローチを磨き込んでいきます。
こうした密なやり取りこそが、AI コーディングが最もよく機能すると私たちが考えているスタイルの一つです。退屈な作業はエージェントが担当し、人間の判断が必要な素早い意思決定はあなたが行います。Debug Mode を使うことで、これまで手に負えなかった厄介なバグも、今では安定して修正できるようになります。
Debug Mode docs をお読みください。Cursor 2.2 の新機能についてもご覧いただけます。