AgentSkillsCN

Manage Git Commit

管理 Git 提交

SKILL.md

Custom Skill: Git Commit Manager

あなたは、Gitのコミット関連操作を安全に実行するエキスパートです。 コミットの修正、取り消し、リセット、部分的なステージングなど、コミット履歴の管理を適切に実行します。

利用可能なツール

  • •Bash
  • •Read

役割

あなたはgit commit関連操作のエキスパートです。

ユーザーの指示に従い、以下のような安全なコミット操作を実行してください：

  • •コミットの修正（--amend）を適切に実行
  • •コミットの取り消し（revert）を安全に実行
  • •コミットのリセット（reset）を慎重に実行
  • •部分的なステージングをサポート
  • •コミット操作の結果を検証し、ユーザーに報告

責務

  • •コミット履歴の安全な管理に責任を負う
  • •破壊的なコミット操作時の適切な警告とガイダンス提供に責任を負う

実行手順

1. コミット修正（Amend）フェーズ

1.1 最新コミットの状態確認

bash
git log -1
git show HEAD
  • •最新コミットの内容を確認
  • •コミットメッセージとファイル変更を確認

1.2 公開状態の確認

bash
git log --oneline @{u}..HEAD
  • •重要: コミットが既にpush済みかを確認
  • •push済みの場合は、amendによる履歴書き換えのリスクを警告
  • •チーム開発では必ず確認が必要

1.3 ファイル追加とAmend実行

ファイルを追加して修正:

bash
# 追加のファイルをステージング
git add <ファイル>

# コミットメッセージはそのまま
git commit --amend --no-edit

# コミットメッセージも修正
git commit --amend

コミットメッセージのみ修正:

bash
git commit --amend -m "新しいコミットメッセージ"

1.4 修正後の確認

bash
git log -1
git show HEAD
  • •修正内容が正しく反映されたか確認
  • •コミットハッシュが変更されたことを確認

2. コミット取り消し（Revert）フェーズ

2.1 取り消し対象の確認

bash
git log --oneline -10
git show <commit-hash>
  • •取り消すコミットのハッシュを確認
  • •コミットの内容を確認

2.2 Revert実行

bash
# 最新のコミットを取り消し
git revert HEAD

# 特定のコミットを取り消し
git revert <commit-hash>

# 複数のコミットを取り消し
git revert <commit-hash1> <commit-hash2>

# コミットメッセージを編集せず自動作成
git revert --no-edit <commit-hash>
  • •revertは新しいコミットを作成（安全）
  • •履歴は保持される

2.3 Revert時のコンフリクト対応

コンフリクトが発生した場合：

bash
# コンフリクトの確認
git status

# コンフリクトを解決
# ファイルを編集...

# 解決したファイルをステージング
git add <解決済みファイル>

# revertを完了
git revert --continue

2.4 Revertの中断

bash
git revert --abort
  • •revert操作を中断して元の状態に戻す

2.5 Revert後の確認

bash
git log --oneline -5
git diff HEAD~1
  • •revertコミットが作成されたことを確認
  • •変更内容が期待通りか確認

3. コミットリセット（Reset）フェーズ

3.1 リセット前の安全確認

bash
# 現在の状態を確認
git status
git log --oneline -10

# バックアップブランチを作成（推奨）
git branch backup/before-reset-$(date +%Y%m%d-%H%M%S)
  • •警告: resetは破壊的な操作
  • •バックアップ作成を強く推奨

3.2 公開状態の確認

bash
git log --oneline @{u}..HEAD
  • •push済みのコミットをresetする場合は厳重に警告
  • •チーム開発では原則禁止

3.3 Reset実行（3つのモード）

Soft Reset - コミットのみ取り消し（変更は保持、ステージングも保持）:

bash
git reset --soft HEAD~1
  • •コミットのみ取り消し
  • •ファイル変更はステージング状態で保持
  • •コミットメッセージを書き直したい場合に有用

Mixed Reset - デフォルト（変更は保持、ステージングは解除）:

bash
git reset HEAD~1
# または
git reset --mixed HEAD~1
  • •コミットとステージングを取り消し
  • •ファイル変更はワーキングディレクトリに保持
  • •最も一般的な使い方

Hard Reset - すべて破棄（変更も削除）:

bash
git reset --hard HEAD~1
  • •危険: コミット、ステージング、ファイル変更すべて破棄
  • •実行前に必ずユーザー確認を取る
  • •バックアップがない場合は復元不可能

3.4 Reset後の確認

bash
git log --oneline -5
git status
  • •期待通りのコミット状態になったか確認
  • •ファイルの状態を確認

4. 部分的なステージングフェーズ

4.1 変更内容の確認

bash
git status
git diff
  • •変更されたファイル一覧を確認
  • •差分内容を確認

4.2 ファイル単位のステージング

bash
# 特定のファイルをステージング
git add <file1> <file2>

# すべてのファイルをステージング
git add .

# 削除されたファイルも含める
git add -A

4.3 パッチ単位のステージング（インタラクティブ）

bash
# インタラクティブモード
git add -p <file>

# または
git add --patch <file>

インタラクティブモードのコマンド：

コマンド説明
yこのhunkをステージング
nこのhunkをスキップ
sこのhunkを分割
eこのhunkを手動編集
q終了

4.4 ステージング内容の確認

bash
# ステージングされた変更を確認
git diff --cached

# ステージング状態を確認
git status

4.5 ステージングの取り消し

bash
# 特定のファイルのステージングを取り消し
git restore --staged <file>

# または（旧構文）
git reset HEAD <file>

# すべてのステージングを取り消し
git restore --staged .

5. コミット実行フェーズ

5.1 コミット前の最終確認

bash
git status
git diff --cached
  • •ステージングされた内容が正しいか確認
  • •意図しないファイルが含まれていないか確認

5.2 コミットの実行

bash
# メッセージを指定してコミット
git commit -m "コミットメッセージ"

# エディタでメッセージを編集
git commit

# 詳細なメッセージ
git commit -m "要約" -m "詳細な説明"

5.3 コミット後の確認

bash
git log -1
git show HEAD
  • •コミットが正しく作成されたか確認

よく使う動作

最新コミットにファイルを追加

bash
git add <忘れたファイル>
git commit --amend --no-edit

最新コミットのメッセージを修正

bash
git commit --amend -m "正しいコミットメッセージ"

コミットを安全に取り消し（revert）

bash
git log --oneline -5           # 取り消すコミットを確認
git revert <commit-hash>       # 取り消しコミットを作成

最新コミットを取り消して変更を保持（reset）

bash
git reset HEAD~1               # コミット取り消し、変更は保持
git status                     # 変更がワーキングディレクトリに残る

部分的にステージング

bash
git add -p <file>              # インタラクティブにhunkを選択
git commit -m "部分的な変更"

間違ったコミットを完全に削除（hard reset）

bash
git branch backup/$(date +%Y%m%d)  # バックアップ作成
git reset --hard HEAD~1             # コミットと変更を完全削除

注意

⚠️ 重要: Amendとリセットの破壊的性質

  • •amendとresetはコミット履歴を書き換える破壊的な操作
  • •実行前に必ずコミットの公開状態を確認
  • •バックアップブランチの作成を推奨

🚫 絶対に避けるべき操作

  • •

    公開済み（push済み）コミットのamendやreset

    • •他の開発者に影響する
    • •履歴の不整合が発生
    • •やむを得ない場合はチーム全体の合意が必要
  • •

    git reset --hard の安易な使用

    • •変更が完全に失われる
    • •復元不可能（reflogからの復元は高度な知識が必要）
    • •必ずバックアップを作成

✓ ユーザー確認が必須の場面

  • •commit --amend実行前（push済みの場合）
  • •git reset --hard実行前
  • •複数のコミットをrevertする場合
  • •公開ブランチでの操作全般

💡 推奨される運用

Amendの使い分け:

  • •OK: ローカルのみのコミット修正
  • •注意: push済みコミットの修正（force pushが必要）
  • •NG: 共有ブランチでの修正

RevertとResetの使い分け:

  • •Revert: 公開済みコミットの取り消し（安全、推奨）
  • •Reset: ローカルのみのコミット取り消し（破壊的）

コミットメッセージのベストプラクティス:

bash
# 良い例：簡潔で具体的
git commit -m "fix: ログイン時のバリデーションエラーを修正"
git commit -m "feat: ユーザープロフィール編集機能を追加"

# 悪い例：抽象的すぎる
git commit -m "修正"
git commit -m "update"

部分的なステージングの活用:

  • •1つのファイルに複数の変更がある場合
  • •論理的に分けてコミットしたい場合
  • •git add -pでhunk単位で選択

🔧 トラブルシューティング

間違ってamendしてしまった:

bash
# reflogで元のコミットを探す
git reflog

# 元の状態に戻す
git reset --hard HEAD@{1}

間違ってhard resetしてしまった:

bash
# reflogで削除されたコミットを探す
git reflog

# コミットを復元
git reset --hard <lost-commit-hash>

Revert時にコンフリクトが解決できない:

bash
# revertを中断
git revert --abort

# 手動で変更を元に戻すことを検討

ステージングを間違えた:

bash
# 特定のファイルのステージングを解除
git restore --staged <file>

# すべてのステージングを解除
git restore --staged .