こんにちは。日々、数千のコミットが飛び交うリポジトリと格闘している皆さん、お疲れ様です。
Gitのブランチ運用、正直「なんとなく」でやっていませんか？ チームが大きくなると、`git branch -a` を打っても、そこには死んだブランチや、誰がいつ作ったのかもわからない残骸が溢れかえる「墓場」と化すのが常です。
今日は、そんな混沌を打破するための、「自分だけのGitブランチ管理ツール」を爆速で作る方法を伝授します。Gitの標準コマンドの裏側を覗き、`git for-each-ref` という最強の武器を使って、あなたの運用を「管理される側」から「支配する側」へ変えましょう。
—
1. なぜ `git branch` では足りないのか？
`git branch` コマンドは人間がパッと見るための「UI」です。しかし、開発チームが数十人規模になり、CI/CDパイプラインが自動生成する一時ブランチが混ざり始めると、そのUIは崩壊します。
ここで登場するのが、`git for-each-ref` です。これは「Gitの内部データベースを直接クエリするエンジン」のようなもの。特定の条件（更新日、著者、名前のパターン）でブランチを抽出し、好きなフォーマットで出力できます。
2. さあ、準備を始めよう
特別なインストールは不要です。あなたのPCにGitが入っていれば、今日から使えます。まずは、このコマンドが何を返してくれるのか、その「素顔」を見てみましょう。
現在のブランチ情報を、更新日時順で表示してみる
git for-each-ref –sort=-committerdate refs/heads/ –format=”%(committerdate:short) | %(authorname) | %(refname:short)”
何が起きたか？
- `–sort=-committerdate`: 新しい順に並べ替え。
- `%(…)`: Git内部のメタデータにアクセス。
- `refs/heads/`: ローカルブランチだけに絞り込む。
これだけで、`git branch` が隠していた「本当の情報」が見えてきませんか？
—
3. 「現実的な」ブランチ管理ツールを作ろう
では、これを実用的な「JSON出力ツール」に昇華させましょう。これをチームのSlackボットやダッシュボードに食わせれば、放置ブランチを自動で検知する仕組みが作れます。
以下のスクリプト（`list-branches.sh`）を保存してください。
!/bin/bash
チーム運用を自動化する：ブランチメタデータ抽出スクリプト
使い方: ./list-branches.sh > branches.json
git for-each-ref refs/heads/ –format='{
“name”: “%(refname:short)”,
“author”: “%(authorname)”,
“date”: “%(committerdate:iso8601)”,
“subject”: “%(contents:subject)”
}’ | jq -s . > branches.json
echo “ブランチ情報をJSONにエクスポートしました。”
(※ `jq` コマンドが必要です。インストールしていない場合は `brew install jq` 等で入れてください。これはエンジニアの必携道具です)
4. 現場で震えるほど役立つ「ハック」：死んだブランチの自動発見
運用していると「2週間以上更新がないfeatureブランチ」を消したくなる時がありますよね。これを手作業でやるのは苦行です。以下のワンライナーで、「古いブランチをリストアップする」までを自動化しましょう。
14日以上更新されていないブランチを抽出
git for-each-ref refs/heads/ –format=”%(refname:short) | %(committerdate:unix)” | \
awk -v now=$(date +%s) -F’|’ ‘$2 < now - (14 86400) {print $1}'
これを使えば、チーム全体で「ゾンビブランチの駆除」を定期的に行う文化が作れます。`awk`で計算させて、古いものをピンポイントで抜く。これができるようになると、リポジトリの健康状態が劇的に向上します。
---
5. 最後に：ツールは「文化」を作る
Gitをただの「保存ツール」として使うのはもったいない。`git for-each-ref` を使って情報を可視化すれば、「どの機能がいつから停滞しているのか」というプロジェクトのボトルネックすら見えてきます。
まずは今日、手元のリポジトリで `git for-each-ref` を叩いてみてください。今まで見えなかった「開発の歴史」が、JSONやテキストとして浮き彫りになるはずです。
「ツールに振り回される」のではなく、「ツールを定義する側」へ。それが、世界最高峰のエンジニアへの第一歩です。
何か詰まったら、いつでも聞いてください。あなたのコードが、より美しく、より効率的になることを応援しています！