【ITニュース解説】Your Agent Never Committed. Snapshot Every Turn to a Git Ref, Then Bisect

システムエンジニアを目指す皆さんにとってGitは必須ツールだが、AIエージェントを使った開発には新たな課題がある。エージェントはコード修正（ターン）ごとにコミットしないため、Git履歴に一つの大きな変更としてしか残らない。これにより、バグが発生した際に「どのターンの修正が原因か」を特定するのが非常に困難になる。

通常のGit開発では、git bisectという強力な機能がバグの原因コミット特定に役立つ。これは、既知の良い状態と悪い状態の間の履歴を二分探索し、バグの原因となったコミットを効率的に見つける。しかし、エージェントが各ターンでコミットを作成しないと履歴がないため、git bisectは使えない。AIエージェントのチェックポイント機能やgit stash createも不十分だ。チェックポイントはBashコマンドによる変更を追跡できず、作業ディレクトリ全体が変更される。git stash createは未追跡ファイルを含まず、履歴が線形にならないためgit bisectには適さない。

そこで提案されるのは、AIエージェントの各ターンを自動的にGitのプライベートな参照（ref）にコミットする仕組みだ。これにより、通常のブランチを汚さずにエージェントの作業履歴を詳細に追跡し、git bisectを適用できるようになる。

この仕組みの第一歩は、エージェントが各ターン完了時に自動実行される「停止フック」（Stop hook）を作成することだ。このフックは、現在の作業ディレクトリの状態をスナップショットとしてコミットするスクリプトである。スクリプトは、現在のコードの変更を実際のステージングエリアに影響させずに一時的に記録し、不要なファイルは含まない。

次に、その一時的な記録からツリーオブジェクトを作成し、前のスナップショットコミットを親とする新しいコミットを作成する。このコミットは、専用のプライベート参照に更新され、エージェントの各ターンが独立した詳細な履歴として記録される。これにより、連続した線形のコミット履歴が形成される。

作成されたターンスナップショットの履歴は、git logコマンドで確認でき、特定のターンの変更はgit diffで、ファイルを過去に戻すにはgit restoreを使う。

次に、「どのターンでバグが混入したか」を特定するためにgit bisectを活用する。メインのリポジトリに影響を与えないよう、「スクラッチワークツリー」という一時的な作業ディレクトリを使うのがポイントだ。一時ディレクトリを作成し、その中でgit bisect startとgit bisect run <テストコマンド>を実行して自動テストを繰り返す。テスト結果に応じてコミットを「良い」または「悪い」と判断することで、git bisectは二分探索で効率的にバグ導入ターンを特定する。複雑な履歴の場合は、全履歴を線形に探索するスクリプトも検討できる。

バグを特定した後、そのターンの変更だけを現在の作業ツリーから元に戻すには、git diffとgit apply -Rコマンドを使う。これにより、特定の変更のみを取り消し、他の修正には影響を与えない。作業が終わり、履歴が不要になったらプライベート参照を削除する。

筆者が開発するHermes IDEは、このスナップショット作成機能の一部を自動で行い、ターンの変更点の確認やファイル復元を可能にする。しかし、git bisectを使った自動テストによるバグ特定はHermes IDEには含まれないため、この部分は手動スクリプトを使って対応することになる。

このアプローチは、AIエージェントを使った開発のデバッグ課題を解決し、開発効率を向上させる。Gitの低レベルな機能を理解し活用することで、高度なバージョン管理の自動化を実現できる好例である。