/ultrareviewのエラーメッセージが親切になった話

Claude Codeには /ultrareview というコマンドがあります。これはコードの変更内容を、ベースとなるブランチと比較しながらレビューしてくれる機能です。v2.1.221では、この機能が失敗したときのエラーメッセージがわかりやすく改善されました。

そもそも何が問題だったのか

/ultrareviewはgitの履歴を使って「どこからどこまでが変更点なのか」を判断しています。ところが、次のようなケースだとその判断ができず、意味の分かりにくいエラーで止まってしまうことがありました。

• リポジトリを浅くクローンしていて、比較対象のブランチの履歴が手元に存在しない
• そもそもローカルにブランチが1つも存在しないチェックアウト状態になっている

特に後者のような、CIのビルド環境などでよくある「ブランチなしのチェックアウト」の状態では、これまでは処理が途中まで進んでからよくわからないエラーで失敗するといった、ちょっと不親切な挙動になっていたようです。

今回何が変わったか

今回のアップデートで変わった点は大きく2つです。

1. ブランチがない場合は最初から拒否してくれる

ブランチが1つも存在しないチェックアウトの場合、Claude Codeは処理を途中まで進めず、最初の時点で「ブランチを作ってください」というアドバイス付きで案内してくれるようになりました。無駄な処理が走らずに、次に何をすればいいかがすぐわかるということです。

2. 見当違いのアドバイスが出なくなった

以前は、履歴が足りないというエラーの際に「git fetch --unshallowを試してください」という案内が出ることがありました。これはリポジトリの完全な履歴を取得し直すためのコマンドです。

ただ、実際にはすでに完全なクローン(浅いクローンではない)なのに、このアドバイスが出てしまうケースがありました。すでに履歴が揃っている人にとっては、「それはもうやってるんだけど」となる、的外れな案内だったわけです。今回の修正で、クローンがすでに完全な場合はこの案内を出さないよう調整されました。

どういう時に関係あるか

普段ローカルの通常のリポジトリで/ultrareviewを使っている分には、あまり意識しない変更かもしれません。ただ、次のような環境では地味に効いてきます。

• GitHub Actionsなど、CI環境で浅いクローン(shallow clone)を使ってチェックアウトしている場合
• detached HEAD状態(ブランチに紐づかないチェックアウト)でコードを触っている場合

こうした環境では、エラーメッセージの精度がそのまま「次に何をすればいいか」の分かりやすさに直結します。今回の変更は機能そのものが増えたわけではありませんが、詰まった時に迷わなくて済むという地味に嬉しい改善です。