Checkpoint Manager

チェックポイント管理スキル

タスクの進捗を一貫性を持って追跡・報告するためのスキルです。

自動提案のタイミング

ワークフロー概要

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  pending    │    │  start      │    │  progress   │    │  complete   │
│  確認       │ → │  開始       │ → │  進捗報告   │ → │  完了       │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
                          ↓
                   ┌─────────────┐
                   │ instruction │
                   │ 指示書管理  │
                   └─────────────┘

詳細は workflow.md を参照。

コマンド一覧

タスク管理

# 未完了タスクの確認
scripts/checkpoint.sh pending

# 新しいタスクを開始（タスクIDは自動生成）
scripts/checkpoint.sh start "<タスク名>" <ステップ数>

# 進捗を報告（指示書使用中のみ）
scripts/checkpoint.sh progress <task-id> <current> <total> "<status>" "<next>"

# タスクを完了（すべての指示書が完了している必要あり）
scripts/checkpoint.sh complete <task-id> "<result>"

# エラーを報告
scripts/checkpoint.sh error <task-id> "<message>"

指示書管理

# 指示書の使用を開始
scripts/checkpoint.sh instruction-start "<path>" "<purpose>" [task-id]

# 指示書の使用を完了
scripts/checkpoint.sh instruction-complete "<path>" "<result>" [task-id]

状態確認

# タスクの詳細履歴を表示
scripts/checkpoint.sh summary <task-id>

使用シナリオ

シナリオ1: 会話開始時

ユーザーが新しい会話を開始したとき、未完了タスクがないか確認を提案：

AI: 未完了のタスクがあるか確認しましょうか？

# 実行
scripts/checkpoint.sh pending

シナリオ2: 新規タスク依頼時

ユーザーが「○○を実装して」などの依頼をしたとき：

AI: チェックポイントを開始しますか？
    タスク名: [ユーザーの依頼内容]
    推定ステップ: [作業の複雑さから推定]

# 実行
scripts/checkpoint.sh start "機能実装" 5
# → タスクID: TASK-123456-abc123

シナリオ3: 指示書使用時

指示書を読み込む前に記録：

AI: 指示書の使用を記録しますか？

# 実行
scripts/checkpoint.sh instruction-start "instructions/ja/presets/web_api.md" "REST API開発" TASK-123456-abc123

シナリオ4: 作業の区切り

一定の作業が完了したとき：

AI: 進捗を報告しますか？
    現在: 2/5 ステップ
    状況: 設計完了
    次: 実装開始

# 実行
scripts/checkpoint.sh progress TASK-123456-abc123 2 5 "設計完了" "実装開始"

シナリオ5: 作業完了時

タスクが完了したとき：

AI: タスクを完了しますか？
    成果: [作業の成果をまとめ]

# 実行（指示書完了を先に）
scripts/checkpoint.sh instruction-complete "instructions/ja/presets/web_api.md" "3エンドポイント実装" TASK-123456-abc123

# その後タスク完了
scripts/checkpoint.sh complete TASK-123456-abc123 "REST API 3エンドポイント実装完了"

ワークフロー制約

判断基準

タスク開始を提案する条件

• ユーザーが具体的な作業を依頼した
• 複数ステップが予想される作業
• 「実装して」「作成して」「修正して」などのキーワード

進捗報告を提案する条件

• 一定量のコード変更があった
• テストが通った/失敗した
• 作業の区切りが明確

タスク完了を提案する条件

• ユーザーが「完了」「できた」と言った
• すべての要求が満たされた
• テストがパスした

注意事項

• タスクIDは自動生成（例: TASK-123456-abc123）
• ステータスとアクションは短く明確に
• 同じタスクでは同じタスクIDを使用
• scripts/checkpoint.sh はプロジェクトルートから実行