Claude-skill-registry checkpoint-manager

タスクの進捗を追跡・管理するスキル。会話開始時に未完了タスクを確認、新規タスク依頼時にタスク開始を提案、作業完了時に完了報告を提案。チェックポイントシステムと連携。

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/checkpoint-manager" ~/.claude/skills/majiayu000-claude-skill-registry-checkpoint-manager && rm -rf "$T"
manifest: skills/data/checkpoint-manager/SKILL.md
source content

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

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

自動提案のタイミング

状況提案内容
会話開始時「未完了タスクを確認しますか?」
新しいタスク依頼時「チェックポイントを開始しますか?」
指示書を読み込む前「指示書使用を記録しますか?」
作業の区切り「進捗を報告しますか?」
作業完了時「タスクを完了しますか?」

ワークフロー概要

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  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省略指示書コマンドでは警告表示

判断基準

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

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

進捗報告を提案する条件

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

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

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

注意事項

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