1natsu-vacation Git 分析
gitリポジトリの状態を分析する — ブランチ、コミット、差分、作業ディレクトリの変更。
いつ使うか
- ブランチで何が変更されたかを分析するとき
- PR作成やコードレビューのために情報を整理するとき
- ブランチの比較やコミット履歴を確認するとき
- コミット前にコード変更を把握するとき
クイックスタート
よく使う操作のヘルパースクリプトを実行する：
# ブランチ差分の要約（デフォルトブランチ、マージベース、コミット数、ファイル統計）
bash scripts/get_branch_diff.sh
# マージベースからの構造化されたコミット履歴
bash scripts/get_commit_history.sh
基本ワークフロー
1. デフォルトブランチとマージベースの特定
DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@')
MERGE_BASE=$(git merge-base origin/$DEFAULT_BRANCH HEAD)
マージベースは現在のブランチが分岐した地点。ベースブランチの現在の状態ではなく、常にここから比較する。
2. 変更の分析
効率のためにこれらを並列実行する：
# 分岐以降のコミット
git log --oneline $MERGE_BASE..HEAD
# ファイル変更の統計
git diff --stat $MERGE_BASE..HEAD
# 構造化されたコミットデータ
git log --format="%H|%s|%an|%ae|%ad" --date=iso $MERGE_BASE..HEAD
3. 作業ディレクトリの確認
git status # 全体のステータス
git diff --cached # ステージ済みの変更
git diff # 未ステージの変更
出力フォーマット
分析結果はまず要約、次に詳細を提示する：
Branch: feature/new-feature (from main)
Diverged at: abc123d (2025-01-15)
5 commits | 12 files changed | +234 -89
Recent commits:
1. feat(api): add new endpoint
2. test(api): add endpoint tests
3. docs(api): update documentation
ヘルパースクリプト
get_branch_diff.sh
構造化されたキーバリューペアを出力する：
DEFAULT_BRANCH: main
MERGE_BASE: abc123def456
COMMITS: 5
CHANGED_FILES: 12
INSERTIONS: 234
DELETIONS: 89
get_commit_history.sh
パイプ区切りのコミットデータを1行ずつ出力する：
hash|subject|author_name|author_email|date
オプションでマージベースを引数として受け取る。省略時は自動検出。
エラーハンドリング
分析前に前提条件を確認する：
# gitリポジトリかどうか確認
git rev-parse --git-dir > /dev/null 2>&1 || echo "Not in a git repository"
# リモートが存在するか確認
git ls-remote origin > /dev/null 2>&1 || echo "Remote 'origin' not found"
リファレンス
高度なgitコマンドパターン、plumbingコマンド、パフォーマンス最適化のヒントは references/git-commands.md を参照。