checkpoint-read

/checkpoint-read

新しいセッションの開始時にプロジェクトのコンテキストを復元するため、チェックポイントコミットの履歴を読み取ります。Git の履歴を検索して /checkpoint-commit によって作成されたチェックポイントコミットを取得し、最も関連性の高い最新のチェックポイントの詳細を表示するとともに、実装済みの内容、残作業、記録された決定事項を要約することで、セッションをシームレスに継続できるようにします。

使用方法: /checkpoint-read

引数は不要です。このコマンドは、ローカル Git 履歴から最新のチェックポイントコミットを自動的に読み取ります。

ワークフロー

以下の手順を順番に実行します。

ステップ 1: 最近のチェックポイントを一覧表示する

Git の履歴からチェックポイントコミットを検索します。

git log --oneline --decorate --grep '^checkpoint.*:' -n 25

• 結果がない場合: 「このリポジトリにチェックポイントコミットは見つかりませんでした。」と報告し、停止します。チェックポイントのコンテキストを使わずにセッションを進めます。
• 結果がある場合: 最近のチェックポイントコミットの一覧を表示し、チェックポイント履歴の概要を示します。

ステップ 2: 最新のチェックポイントを読み取る

一覧の先頭にある最新のチェックポイントから SHA を取り出し、その詳細をすべて読み取ります。

# Show commit stats (files changed)
git show --stat {SHA}

# Show full commit message and diff
git show {SHA}

コンテキストを復元するため、コミットメッセージの件名と本文を解析します。

ステップ 3: コンテキストを要約する

チェックポイントコミットのメッセージを分析し、次の 3 つのセクションに分けて要約します。

1. 実装済みの内容: コミット本文の箇条書きと差分の内容から、完了した作業を抽出します。
2. 残作業: コミットメッセージに記載された保留項目、TODO、未完了の作業を特定します。
3. 記録された決定事項: コミットメッセージに記録されたアーキテクチャまたは設計上の決定事項を記載します。

ステップ 4: 報告する

以下を含む構造化された要約をユーザーに提示します。

• 参照用のチェックポイントコミット SHA と日付
• コミットの件名に含まれる CR 識別子（例: CR-XXXX）
• 3 つのセクションによるコンテキストの要約（実装済みの内容、残作業、決定事項）

安全ルール

• 絶対に実行してはならない操作: git reset、git rebase、git commit --amend、git push --force など、破壊的な Git 操作
• 絶対に行ってはならない操作: コミットの作成、ファイルの変更、その他あらゆる Git 状態の変更
• 必ず読み取り専用にすること: Git の照会コマンドのみを許可します
• 必ずローカルの Git 操作のみを使用すること: ネットワーク呼び出しは禁止します