Gitの深淵へ：Plumbingコマンドでコミットグラフを「外科手術」する技術
世の中のエンジニアの9割は、`git commit`や`git push`という「高級コマンド（Porcelain）」の皮膜の上で生活している。だが、プロジェクトが数年続き、履歴が汚染され、巨大なバイナリが混入し、コミットグラフがスパゲッティ化したとき、その「皮膜」は無力だ。
今日は、`git-filter-repo`すら使えない極限の状況において、Gitの真の心臓部であるオブジェクトデータベースを直接操作するPlumbing（配管）コマンドの世界へ案内する。
—
1. なぜ「Plumbing」を知る必要があるのか
Gitのデータ構造は、シンプル極まりない「キー・バリュー・ストア」だ。
- Blob: ファイルの中身そのもの
- Tree: ディレクトリ構造
- Commit: Treeへのポインタとメタデータ
これらを直接操作できれば、履歴の改竄、巨大ファイルの削除、あるいは破損したリポジトリの復旧が「外科手術」レベルの精度で行える。
必須のPlumbingコマンド三種の神器
1. `git cat-file -p
2. `git hash-object -w
3. `git commit-tree`: ツリーを指定して新しいコミットオブジェクトを生成する（`git commit`と違い、インデックスを介さない）。
—
2. 実践：コミットグラフの外科手術
例えば、「特定の巨大ファイルを歴史のすべてから削除し、かつコミットメッセージを修正したい」というケース。`git filter-branch`は遅すぎて話にならない。以下の手順でバイパスする。
1. 目的のツリーから不要なファイルを削除した新しいツリーを作成する
既存のツリーの内容を読み込み、不要なパスを除外して書き込む
NEW_TREE=$(git ls-tree -r HEAD | grep -v “huge_binary.bin” | git mktree)
2. 親コミットを継承しつつ、新しいツリーでコミットオブジェクトを生成
-p で親を指定することで、既存のグラフを維持したまま上書きが可能
NEW_COMMIT=$(echo “Remove huge binary and fix typo” | git commit-tree $NEW_TREE -p HEAD^)
3. ブランチの参照先を新しいコミットに強制移動
git update-ref refs/heads/main $NEW_COMMIT
この手法を使えば、数百万のコミットがあろうとも、瞬時に履歴を再構築できる。これが「Gitの設計思想を理解する」ことの真価だ。
—
3. 開発スピードを加速させる「神」設定とツール
知識だけでなく、環境も極めろ。現場のテックリードとして譲れない設定を共有する。
A. 絶対に入れるべき「神プラグイン」
- [delta](https://github.com/dandavison/delta): `git diff`の出力を爆速で読みやすくする。これを入れるだけでレビュー時間が30%短縮される。
- [fzf](https://github.com/junegunn/fzf): Gitのブランチ切り替えやログ検索を爆速化する。「`git branch`で探す」という行為は過去の遺物だ。
B. 実践的な `.gitconfig` の最適化
以下の設定を全エンジニアに強制せよ。
[alias]
# 履歴を視覚化する最強のコマンド。これ以外を使う必要はない
lg = log –graph –pretty=format:’%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset’ –abbrev-commit
# 衝突した際に最も安全に復旧する設定
push = push –force-with-lease
[fetch]
# フェッチ時にすべてのリモート追跡ブランチを更新
prune = true
[pull]
# マージコミットを作らず、リベースを強制。履歴の清潔さは正義
rebase = true
—
4. チームで共有すべき「Git運用ルール」
ツールを使いこなしても、運用がズレれば崩壊する。私がチームで徹底しているルールだ。
1. 「マージコミット」は禁止: 全てを`rebase`で解決させる。ログは直線であるべきだ。分岐が必要な場合も、必ずスコープを小さく保ち、`rebase`でメインストリームに統合させる。
2. `git commit –amend`の神聖化: プッシュする前のコミットは「ゴミ」だ。必ず整理しろ。`–amend`でメッセージを整え、`rebase -i`でコミットをまとめるまでがコーディングである。
3. コミットメッセージの構造:
- `feat:`, `fix:`, `refactor:`, `chore:` のプレフィックスを強制する。
- 最初の1行は50文字以内。
- 2行空けてから、なぜその変更が必要だったのかの「背景」を書く。
—
最後に：Gitは「道具」ではなく「歴史」である
Plumbingコマンドを扱うということは、プロジェクトの歴史を直接編集するということだ。それは非常に強力だが、責任も伴う。
チームのメンバーにはこう伝えてほしい。「Gitの操作で悩む時間は、エンジニアにとって最も生産性の低い時間だ。コマンドを指に覚えさせ、Gitの内部構造を理解し、思考の速度でコードを管理しろ」と。
この深淵に触れた君なら、もうブランチ操作で迷うことはないはずだ。さあ、ターミナルを開いて、美しいコミットグラフを描こう。