git-sequential-stageはhunk単位の部分的なステージングを実行するためのツールです。 git-sequential-stageを用いて大きな変更を論理的な単位に分割してコミットしてください。
# hunk番号を指定して部分的にステージング
git-sequential-stage -patch="path/to/changes.patch" -hunk="src/main.go:1,3,5"
# ファイル全体をステージング（ワイルドカード使用）
git-sequential-stage -patch="path/to/changes.patch" -hunk="src/logger.go:*"
# 複数ファイルの場合（ワイルドカードと番号指定の混在も可能）
git-sequential-stage -patch="path/to/changes.patch" \
-hunk="src/main.go:1,3" \
-hunk="src/utils.go:*" \
-hunk="docs/README.md:*"実行手順
Step 0: リポジトリルートに移動
Step 1: 差分を取得
git ls-files --others --exclude-standard | xargs git add -N
# より安定した位置特定のため
git diff HEAD > .claude/tmp/current_changes.patchStep 2: 分析
hunk単位で変更を分析し、最初のコミットに含めるhunkを決定してください
- hunkの内容を読み取る: 各hunkが何を変更しているか理解
- 意味的グループ化: 同じ目的の変更（バグ修正、リファクタリング等）をグループ化
- コミット計画: どのhunkをどのコミットに含めるか決定
# 全体のhunk数
grep -c "^@@" .claude/tmp/current_changes.patch
# 各ファイルのhunk数
git diff HEAD --name-only | xargs -I {} sh -c 'printf "%s: " "{}"; git diff HEAD {} | grep -c "^@@"'Step 3: 自動ステージング
選択したhunkをgit-sequential-stageで自動的にステージングしてください
# git-sequential-stageを実行（内部で逐次ステージングを安全に処理）
# 部分的な変更をステージング（hunk番号指定）
git-sequential-stage -patch=".claude/tmp/current_changes.patch" -hunk="src/calculator.py:1,3,5"
# ファイル全体をステージング（意味的に一体の変更の場合）
git-sequential-stage -patch=".claude/tmp/current_changes.patch" -hunk="tests/test_calculator.py:*"
# 複数ファイルの場合（混在使用）
git-sequential-stage -patch=".claude/tmp/current_changes.patch" \
-hunk="src/calculator.py:1,3,5" \
-hunk="src/utils.py:2" \
-hunk="docs/CHANGELOG.md:*"
# コミット実行
git commit -m "$COMMIT_MSG"Step 4: 繰り返し
Step 5: 最終確認
ワイルドカード使用の判断基準
- 新規ファイルの追加
- すべての変更が同じ目的（例：ファイル全体のリファクタリング、ドキュメント更新）
- 「hunkを数えるのが面倒」という理由で使用するものではない。