🛠️ 開発・MCP コミュニティ

checkpoint-manager

安全な試行錯誤のために、現在の状態を保存して変更を元に戻したり、復旧ポイントを管理したりすることで、システムを安心して実験できる状態に戻せるようにするSkill。

📜 元の英語説明(参考)

State snapshots and rollback for safe experimentation. Use when creating checkpoints, rolling back changes, managing recovery points, or implementing safe experimentation.

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o checkpoint-manager.zip https://jpskill.com/download/9391.zip && unzip -o checkpoint-manager.zip && rm checkpoint-manager.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/9391.zip -OutFile "$d\checkpoint-manager.zip"; Expand-Archive "$d\checkpoint-manager.zip" -DestinationPath $d -Force; ri "$d\checkpoint-manager.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して checkpoint-manager.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → checkpoint-manager フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

チェックポイントマネージャー

自律コーディング中に安全なロールバックを行うための、状態チェックポイントの作成と管理を行います。

クイックスタート

チェックポイントの作成

from scripts.checkpoint_manager import CheckpointManager

manager = CheckpointManager(project_dir)
checkpoint = await manager.create_checkpoint(
    name="before-refactor",
    description="大規模なリファクタリング前の状態"
)

チェックポイントへのロールバック

await manager.rollback(checkpoint.id)
# または最新のものにロールバック
await manager.rollback_to_latest()

チェックポイントのワークフロー

┌─────────────────────────────────────────────────────────────┐
│                 CHECKPOINT WORKFLOW                          │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  CREATE CHECKPOINT                                           │
│  ├─ gitの状態をキャプチャ (コミットハッシュ、変更されたファイル)           │
│  ├─ 機能リストのスナップショット                                   │
│  ├─ 進捗ファイルの保存                               │
│  ├─ コンテキストの記録 (セッション、トークン)                       │
│  └─ チェックポイントメタデータの保存                               │
│                                                              │
│  RISKY OPERATION                                             │
│  ├─ 操作の試行                                       │
│  ├─ 成功した場合 → 継続                                   │
│  └─ 失敗した場合 → チェックポイントへのロールバック                    │
│                                                              │
│  ROLLBACK                                                    │
│  ├─ チェックポイントデータのロード                                    │
│  ├─ チェックポイントのコミットへのGitリセット                         │
│  ├─ 機能リストの復元                                   │
│  ├─ 進捗ファイルの復元                                  │
│  └─ 一時ファイルのクリーンアップ                               │
│                                                              │
└─────────────────────────────────────────────────────────────┘

チェックポイントの構造

{
  "id": "checkpoint-20250115-103000",
  "name": "before-refactor",
  "description": "大規模なリファクタリング前の状態",
  "timestamp": "2025-01-15T10:30:00",
  "git_state": {
    "commit_hash": "abc1234",
    "branch": "main",
    "dirty_files": ["src/app.ts"]
  },
  "feature_state": {
    "current": "auth-003",
    "completed": ["auth-001", "auth-002"],
    "snapshot_path": ".claude/checkpoints/checkpoint-xxx/feature_list.json"
  },
  "context": {
    "session_number": 5,
    "token_usage": 45000
  }
}

チェックポイントの種類

種類	トリガー	保持期間
Automatic	リスクのある操作の前	最新の5つ
Manual	ユーザー/エージェントのリクエスト	削除されるまで
Feature	機能完了後	永続的
Session	セッションの開始時	最新の3つ

統合ポイント

error-recoverer: 失敗時にロールバックをトリガーします
coding-agent: 変更前にチェックポイントを作成します
autonomous-loop: チェックポイントのライフサイクルを管理します
context-state-tracker: チェックポイントに状態を提供します

参考文献

references/CHECKPOINT-STRATEGY.md - 戦略ガイド
references/ROLLBACK-PROCEDURES.md - ロールバックの詳細

スクリプト

scripts/checkpoint_manager.py - コアマネージャー
scripts/git_snapshot.py - Gitの状態キャプチャ
scripts/state_snapshot.py - 機能/進捗のキャプチャ
scripts/rollback_handler.py - ロールバックの実行

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Checkpoint Manager

Creates and manages state checkpoints for safe rollback during autonomous coding.

Quick Start

Create Checkpoint

from scripts.checkpoint_manager import CheckpointManager

manager = CheckpointManager(project_dir)
checkpoint = await manager.create_checkpoint(
    name="before-refactor",
    description="State before major refactoring"
)

Rollback to Checkpoint

await manager.rollback(checkpoint.id)
# or rollback to latest
await manager.rollback_to_latest()

Checkpoint Workflow

┌─────────────────────────────────────────────────────────────┐
│                 CHECKPOINT WORKFLOW                          │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  CREATE CHECKPOINT                                           │
│  ├─ Capture git state (commit hash, dirty files)           │
│  ├─ Snapshot feature list                                   │
│  ├─ Save progress file state                               │
│  ├─ Record context (session, tokens)                       │
│  └─ Store checkpoint metadata                               │
│                                                              │
│  RISKY OPERATION                                             │
│  ├─ Attempt operation                                       │
│  ├─ If success → Continue                                   │
│  └─ If failure → Rollback to checkpoint                    │
│                                                              │
│  ROLLBACK                                                    │
│  ├─ Load checkpoint data                                    │
│  ├─ Git reset to checkpoint commit                         │
│  ├─ Restore feature list                                   │
│  ├─ Restore progress file                                  │
│  └─ Clean up temporary files                               │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Checkpoint Structure

{
  "id": "checkpoint-20250115-103000",
  "name": "before-refactor",
  "description": "State before major refactoring",
  "timestamp": "2025-01-15T10:30:00",
  "git_state": {
    "commit_hash": "abc1234",
    "branch": "main",
    "dirty_files": ["src/app.ts"]
  },
  "feature_state": {
    "current": "auth-003",
    "completed": ["auth-001", "auth-002"],
    "snapshot_path": ".claude/checkpoints/checkpoint-xxx/feature_list.json"
  },
  "context": {
    "session_number": 5,
    "token_usage": 45000
  }
}

Checkpoint Types

Type	Trigger	Retention
Automatic	Before risky operations	Last 5
Manual	User/agent request	Until deleted
Feature	After feature complete	Permanent
Session	Start of session	Last 3

Integration Points

error-recoverer: Triggers rollback on failures
coding-agent: Creates checkpoints before changes
autonomous-loop: Manages checkpoint lifecycle
context-state-tracker: Provides state to checkpoint

References

references/CHECKPOINT-STRATEGY.md - Strategy guide
references/ROLLBACK-PROCEDURES.md - Rollback details

Scripts

scripts/checkpoint_manager.py - Core manager
scripts/git_snapshot.py - Git state capture
scripts/state_snapshot.py - Feature/progress capture
scripts/rollback_handler.py - Rollback execution