# Checkpoint

> ワークフローのチェックポイント管理ガイド。gitを活用して作業の進捗を記録・検証・比較する。チェックポイントの作成、検証、一覧表示、クリアをサポート。「チェックポイントを作成」「進捗を記録」「状態を保存」「チェックポイントと比較」「checkpoint」などのフレーズで発動。 Use when this capability is needed.

- Skill: `tomevault-io/checkpoint-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/checkpoint-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/checkpoint-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/checkpoint-3

---


# チェックポイント管理（Checkpoint）

ワークフローにおけるチェックポイントの作成・検証を行うためのガイド。

## このスキルの目的

1. **進捗の記録** - 作業の節目でgit状態を保存
2. **状態の検証** - 過去のチェックポイントとの比較
3. **履歴の管理** - チェックポイント一覧の表示とクリーンアップ

## 使用方法

```
checkpoint {action} {name}
```

アクション:
- `create {name}` - 名前付きチェックポイントを作成
- `verify {name}` - 名前付きチェックポイントと検証
- `list` - すべてのチェックポイントを表示
- `clear` - 古いチェックポイントを削除（最新5件は保持）

## ワークフロー

### チェックポイントの作成

チェックポイントを作成する際の手順:

1. 現在の状態がクリーンであることを確認
2. git stashまたはコミットをチェックポイント名で作成
3. チェックポイントを `.claude/checkpoints.log` に記録:

```bash
echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log
```

4. チェックポイント作成を報告

### チェックポイントの検証

チェックポイントと比較検証する際の手順:

1. ログからチェックポイントを読み込む
2. 現在の状態とチェックポイントを比較:
   - チェックポイント以降に追加されたファイル
   - チェックポイント以降に変更されたファイル
   - テスト合格率の変化
   - カバレッジの変化

3. 以下の形式で報告:

```
チェックポイント比較: {name}
============================
変更ファイル数: X
テスト: +Y 合格 / -Z 失敗
カバレッジ: +X% / -Y%
ビルド: [成功/失敗]
```

### チェックポイント一覧

すべてのチェックポイントを以下の情報とともに表示:
- 名前
- タイムスタンプ
- Git SHA
- ステータス（現在、遅れ、先行）

## 典型的なワークフロー

```
[開始] --> checkpoint create "feature-start"
   |
[実装] --> checkpoint create "core-done"
   |
[テスト] --> checkpoint verify "core-done"
   |
[リファクタリング] --> checkpoint create "refactor-done"
   |
[PR] --> checkpoint verify "feature-start"
```

## 重要な注意事項

- チェックポイントはgitの状態を基準に動作する
- `.claude/checkpoints.log` ファイルでチェックポイント履歴を管理
- `clear` 実行時は最新5件を保持し、それ以前のものを削除

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nagasakah) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->

