checkpoint

Git チェックポイントシステム

安全なコード探索と復元のために、Git チェックポイント（スタッシュ）を管理します。

呼び出すタイミング

• リスクの高い変更やリファクタリングを行う前
• コミットせずにすばやく保存ポイントを作成したいとき
• 実験に失敗した後、以前の状態に戻したいとき
• 複数の作業中の状態を維持したいとき

使い方

/checkpoint create [name]     # Create a named checkpoint
/checkpoint list              # List checkpoints
/checkpoint restore [name]    # Restore a specific checkpoint
/checkpoint pop               # Restore the most recent checkpoint
/checkpoint clear             # Remove checkpoints

手順

チェックポイントの作成

1. Git リポジトリ内にいるか確認します
2. 未コミットの変更があるか確認します
3. 次の名前で Git スタッシュを作成します：claude-checkpoint_YYYYMMDD_HHMMSS: [name]
4. チェックポイントが作成されたことを確認します

チェックポイントの一覧表示

1. git stash list を実行します
2. claude-checkpoint で始まるスタッシュを絞り込みます
3. 次の項目を含む書式付きの表で表示します：
   • インデックス（stash@{N}）
   • タイムスタンプ
   • 説明
   • 変更されたファイルの数

チェックポイントの復元

1. 指定された名前またはインデックスに一致するスタッシュを探します
2. git stash apply stash@{N} でスタッシュを適用します
3. スタッシュは安全のため保持し、削除しないでください
4. 復元の詳細を報告します

チェックポイントのポップ

1. 最近の claude-checkpoint スタッシュを探します
2. git stash pop stash@{N} で適用します
3. 復元の詳細を報告します

チェックポイントの削除

1. claude-checkpoint スタッシュを一覧表示します
2. 実行前に確認を求めます
3. 一致するスタッシュをそれぞれ削除します
4. 削除数を報告します

例

# Create checkpoint before risky changes
/checkpoint create "before refactoring auth module"

# List checkpoints
/checkpoint list

# Restore if something went wrong
/checkpoint restore "before refactoring auth module"

# Quick restore of the recent one
/checkpoint pop

# Clean up old checkpoints
/checkpoint clear

メモ

• チェックポイントは内部で Git stash を使用します
• チェックポイントには未追跡ファイルも含めます
• チェックポイントはセッションをまたいで保持されます
• 識別しやすい説明的な名前を付けてください