name: checkpoint-manager description: タスクの進捗を追跡・管理するスキル。会話開始時に未完了タスクを確認、新規タスク依頼時にタスク開始を提案、作業完了時に完了報告を提案。チェックポイントシステムと連携。
チェックポイント管理スキル
タスクの進捗を一貫性を持って追跡・報告するためのスキルです。
自動提案のタイミング
| 状況 | 提案内容 |
|---|---|
| 会話開始時 | 「未完了タスクを確認しますか？」 |
| 新しいタスク依頼時 | 「チェックポイントを開始しますか？」 |
| 指示書を読み込む前 | 「指示書使用を記録しますか？」 |
| 作業の区切り | 「進捗を報告しますか？」 |
| 作業完了時 | 「タスクを完了しますか？」 |
ワークフロー概要
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 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はプロジェクトルートから実行