tomevault-io Checkpointing — セッションコンテキストの永続化
セッション中の作業履歴を保存し、再利用可能なスキルパターンを発見します。
モード
Mode 1: Session History（デフォルト）
CLI相談履歴を各エージェントの設定ファイルに追記。
┌─────────────────────────────────────────────────────────────┐
│ .claude/logs/cli-tools.jsonl │
│ ↓ │
│ /checkpointing │
│ ↓ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ CLAUDE.md │ │ AGENTS.md │ │ GEMINI.md │ │
│ │ ## Session │ │ ## Session │ │ ## Session │ │
│ │ History │ │ History │ │ History │ │
│ └──────────────┘ └──────────────┘ └──────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Mode 2: Full Checkpoint（--full）
作業全体の包括的なスナップショットを作成。
┌─────────────────────────────────────────────────────────────┐
│ 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）
チェックポイントからスキル化できるパターンを発見。
┌─────────────────────────────────────────────────────────────┐
│ /checkpointing --full --analyze │
│ ↓ │
│ 1. Full Checkpoint を生成 │
│ 2. 分析用プロンプトを生成 │
│ → .claude/checkpoints/YYYY-MM-DD-HHMMSS.analyze-prompt.md│
│ ↓ │
│ 3. サブエージェントでAI分析を実行 │
│ → 作業パターンを発見 │
│ → スキル候補を提案 │
│ ↓ │
│ 4. 新スキルを .claude/skills/ に追加 │
└─────────────────────────────────────────────────────────────┘
発見するパターン例:
- テスト→実装の繰り返し（TDDワークフロー）
- リサーチ→設計→実装の流れ
- 特定ファイルセットの同時変更
- CLI相談→コード変更のシーケンス
使い方
# 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 の実行フロー
# 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 フォーマット
# 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 フォーマット
## 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が自由に発見する設計
Converted and distributed by TomeVault — claim your Tome and manage your conversions.