Checkpointing — セッションコンテキストの永続化

セッション中の作業履歴を保存し、再利用可能なスキルパターンを発見します。

モード

Mode 1: Session History（デフォルト）

CLI相談履歴を各エージェントの設定ファイルに追記。

code

┌─────────────────────────────────────────────────────────────┐
│  .claude/logs/cli-tools.jsonl                               │
│                      ↓                                      │
│  /checkpointing                                             │
│                      ↓                                      │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│  │  CLAUDE.md   │ │ AGENTS.md    │ │ GEMINI.md            │ │
│  │ ## Session   │ │ ## Session   │ │ ## Session           │ │
│  │ History      │ │ History      │ │ History              │ │
│  └──────────────┘ └──────────────┘ └──────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Mode 2: Full Checkpoint（--full）

作業全体の包括的なスナップショットを作成。

code

┌─────────────────────────────────────────────────────────────┐
│  Data Sources:                                              │
│  ├─ git log (commits)                                       │
│  ├─ git diff (file changes)                                 │
│  └─ cli-tools.jsonl (Codex/Gemini logs)                     │
│                      ↓                                      │
│  /checkpointing --full                                      │
│                      ↓                                      │
│  .claude/checkpoints/2026-01-28-153000.md                   │
│  ├─ Summary (commits, files, consultations)                 │
│  ├─ Git History (commits list)                              │
│  ├─ File Changes (created, modified, deleted)               │
│  └─ CLI Consultations (Codex/Gemini)                        │
└─────────────────────────────────────────────────────────────┘

Mode 3: Skill Analysis（--full --analyze）

チェックポイントからスキル化できるパターンを発見。

code

┌─────────────────────────────────────────────────────────────┐
│  /checkpointing --full --analyze                            │
│                      ↓                                      │
│  1. Full Checkpoint を生成                                   │
│  2. 分析用プロンプトを生成                                    │
│     → .claude/checkpoints/YYYY-MM-DD-HHMMSS.analyze-prompt.md│
│                      ↓                                      │
│  3. サブエージェントでAI分析を実行                            │
│     → 作業パターンを発見                                      │
│     → スキル候補を提案                                        │
│                      ↓                                      │
│  4. 新スキルを .claude/skills/ に追加                         │
└─────────────────────────────────────────────────────────────┘

発見するパターン例:

•テスト→実装の繰り返し（TDDワークフロー）
•リサーチ→設計→実装の流れ
•特定ファイルセットの同時変更
•CLI相談→コード変更のシーケンス

使い方

bash

# Session History モード（デフォルト）
/checkpointing

# Full Checkpoint モード
/checkpointing --full

# Skill Analysis モード（推奨）
/checkpointing --full --analyze

# 期間指定
/checkpointing --since "2026-01-26"
/checkpointing --full --analyze --since "2026-01-26"

Skill Analysis の実行フロー

bash

# Step 1: チェックポイント + 分析プロンプト生成
python checkpoint.py --full --analyze

# Step 2: サブエージェントで分析（Claudeが自動実行）
# → 分析プロンプトを読み込み
# → スキル候補を提案
# → ユーザーが承認したらスキルを生成

処理内容

Session History モード

•.claude/logs/cli-tools.jsonl を解析
•Codex/Geminiへの相談内容を日付ごとに整理
•各エージェント設定ファイルに ## Session History を追記

Full Checkpoint モード

•
Git情報を収集
- •git log でコミット履歴
- •git diff --name-status でファイル変更
- •git diff --numstat で行数変更
•
CLI相談ログを解析
- •Codex相談内容とステータス
- •Gemini調査内容とステータス
•
チェックポイントファイルを生成
- •.claude/checkpoints/YYYY-MM-DD-HHMMSS.md

Full Checkpoint フォーマット

markdown

# Checkpoint: 2026-01-28 15:30:00 UTC

## Summary
- **Commits**: 5
- **Files changed**: 12 (8 modified, 3 created, 1 deleted)
- **Codex consultations**: 3
- **Gemini researches**: 2

## Git History

### Commits
- `abc1234` Add checkpointing enhancement
- `def5678` Update documentation

### File Changes

**Created:**
- `new_feature.py` (+120)

**Modified:**
- `checkpoint.py` (+80, -20)
- `SKILL.md` (+45, -10)

**Deleted:**
- `old_script.py`

## CLI Tool Consultations

### Codex (3 consultations)
- ✓ 設計: チェックポイント拡張アーキテクチャ
- ✓ デバッグ: Git log parsing issue

### Gemini (2 researches)
- ✓ 調査: Git integration best practices

Session History フォーマット

markdown

## Session History

### 2026-01-26

**Codex相談:**
- ✓ サブエージェントパターンでCodex/Gemini呼び出しを推奨...

**Gemini調査:**
- ✓ MCP vs CLI比較調査...

実行タイミング

タイミング	推奨モード
セッション終了前	`--full --analyze`
重要な設計決定後	`--full`
大きな機能実装完了後	`--full --analyze`
長時間作業の区切り	`--full`
繰り返しパターンを感じた時	`--full --analyze`
日次の軽い記録	デフォルト

注意事項

•ログが空の場合は何も追記されません
•既存の ## Session History セクションは上書きされます
•ログファイル自体は変更されません（読み取りのみ）
•Full Checkpoint は .claude/checkpoints/ に蓄積されます
•Git未初期化プロジェクトでもCLIログ部分は動作します
•--analyze で生成されたスキル提案は人間がレビューしてから採用すること
•スキル分析はパターンを固定せず、AIが自由に発見する設計