パッチ系列の更新を、コミット単位で読み直す

Git公式の`git-range-diff`文書は、2つのパッチ系列、より一般には2つのコミット範囲の違いを表示するコマンドを説明しています。この記事ではGit v2.55.0のtagに対応するcommit `e9019fcafe0040228b8631c30f97ae1adb61bcdc`へ資料を固定しました。git-scmのversion別公式文書では、v2.55.0の更新日が2026年6月29日と表示されています。Git本体のライセンスはGNU General Public License version 2です。

公式文書によると、`range-diff`は両範囲のpatch、すなわち著者情報、commit message、commit diffの近さから対応するcommit候補を探し、新しい側の順序で表示します。merge commitは既定で比較対象から外れます。大きな変更を削除と追加に分けてしまう場合などは、既定60の`--creation-factor`を調整できます。ただし、対応付けは最小コストの推定であり、同じ目的の変更だと保証するものではありません。

出力は人が読むためのporcelainで、Gitのversionをまたいで文字列が安定する形式でも、機械可読な形式でもありません。公式資料はこの記事のSkill案を提供、評価、推奨していません。この記事は、公式コマンドの結果をレビューの確認項目へ読み替える提案です。

Skill案では、利用者が指定した信頼できるローカルrepositoryと、旧版・新版それぞれのcommit範囲を入力にします。最初にGit version、各refが指すcommit、実行した範囲式を記録し、working tree、branch、remoteを書き換えずに`git range-diff --no-color`を実行します。出力から、同一と推定されたcommit、内容が変わった対応候補、旧版だけ、新版だけの項目を、人が確認する一覧へ整理します。

対応が不自然な場合は、範囲指定の誤りと大幅なpatch変更を先に確認します。`--creation-factor`を変える場合は、値と前後の結果を並べて感度確認として扱い、都合のよい対応だけを正解にしません。2026年9月11日にGit 2.53.0で作った小さなfixtureでは、既定値が1行の値変更を削除と追加に分け、`--creation-factor=100`では同じcommitの変更候補として対応付けました。これは小さな実測例で、他のrepositoryでも100が適切だという意味ではありません。

この整理だけでは、変更意図、正しさ、回帰、test結果、review commentへの対応を確定できません。出力は文字列parserへ渡さず、原文、Git version、範囲、補助optionとともに人間向けの証拠として残します。mergeを含む履歴は既定で無視されるため、必要なら公式文書に従って別途確認し、Skillが自動でrebase、checkout、fetch、pushを行わない設計にします。