Agent skill

checkpoint-manager

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

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/dobachi/AI_Instruction_Kits/tree/main/templates/claude-skills/ja/checkpoint-manager

SKILL.md

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

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

自動提案のタイミング

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

ワークフロー概要

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

詳細は workflow.md を参照。

コマンド一覧

タスク管理

bash
# 未完了タスクの確認
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>"

指示書管理

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

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

状態確認

bash
# タスクの詳細履歴を表示
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/coding/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/coding/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 はプロジェクトルートから実行

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

dobachi/AI_Instruction_Kits

auto-build

プロジェクトタイプを自動検出してビルドを実行するスキル。コード変更後にビルドを提案、エラー発生時は修正案を提示。Node.js、Rust、Python、Go、Makefileプロジェクトに対応。

1 0
Explore
dobachi/AI_Instruction_Kits

commit-safe

安全なコミットを支援するスキル。変更内容を確認してから選択的にコミット。大きな変更時にファイル指定コミットを提案、git add -Aの使用を防止。

1 0
Explore
dobachi/AI_Instruction_Kits

worktree-manager

Git worktreeの作成・管理を行うスキル。複雑なタスクや複数ファイル変更時にworktree作成を提案、タスク完了時にマージ・クリーンアップを案内。checkpoint-managerと連携。

1 0
Explore
dobachi/AI_Instruction_Kits

auto-build

Skill for auto-detecting project type and executing builds. Suggests builds after code changes, proposes fixes for build errors. Supports Node.js, Rust, Python, Go, and Makefile projects.

1 0
Explore
dobachi/AI_Instruction_Kits

checkpoint-manager

Skill for tracking and managing task progress. Checks pending tasks at conversation start, proposes task creation for new requests, suggests completion reports when work is done. Integrates with checkpoint system.

1 0
Explore
dobachi/AI_Instruction_Kits

commit-safe

Skill for safe commits. Reviews changes before selective commits. Proposes file-specific commits for large changes, prevents use of git add -A.

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results