セッション再開スキル

目的: 中断後（ノートパソコンのスリープ、セッションタイムアウト、レート制限一時停止、クレジット枯渇など）の作業をシームレスに再開します。再発見に無駄なクレジットを消費しません。

使用時機: 新しいセッション開始時、レート制限一時停止後、ノートパソコン起動時、またはユーザーが「再開」と言った時。

---

フェーズ 1: 発見

サブエージェント: StateLoader (モデル: haiku)

• ツール: Read、Glob、Bash
• プロンプト: 保存されたすべての状態を読み込みます。.claude/local/state/*.json から予備状態をチェック。.claude/local/checklists/*.md からチェックリスト進行状況をチェック。git status からコミットされていない作業をチェック。git log --oneline -3 から最近のコミットをチェック。存在するものを報告します。
• 出力: { state_files[], checklist_files[], uncommitted_files[], recent_commits[], server_needed: boolean }
• ゲート: 状態が読み込まれた

フェーズ 2: 計画

サブエージェント: GapAnalyzer (モデル: haiku)

• ツール: Read
• プロンプト: 読み込まれた状態を分析します。各チェックリストについて: DONE、TODO、BLOCKED の数をカウント。最初の TODO 項目を特定。DONE マークされた後にファイルが変更された古い項目（STALE）がないかチェック。再開順序を計画。サーバーが必要かどうかを判定します。
• 出力: { items_done, items_remaining, first_todo, stale_items[], server_needed: boolean, resume_plan[] }
• ゲート: ギャップが特定され、かつ再開計画が作成された

フェーズ 3: 実装

サブエージェント: ResumeExecutor (モデル: haiku)

• ツール: Bash、Read、Write、Edit
• プロンプト: 再開ステップを実行します。コミットされていない作業がある場合 → ユーザーに確認: コミットするか廃棄するか。サーバーが必要な場合 → server-lifecycle を呼び出し。古い項目がある場合 → ステータスを TODO に変更。元のスキルのフェーズ 3 を使用して最初の TODO 項目から開始します。
• 出力: { uncommitted_handled, server_started, stale_refreshed, current_item }
• ゲート: 再開ポイントに到達した

フェーズ 4: 検証

サブエージェント: ResumeVerifier (モデル: haiku)

• ツール: Bash、Read
• プロンプト: 再開状態が正しいことを検証します。npm test を実行して既存の作業が引き続き成功することを確認。必要に応じてサーバーをチェック。チェックリストが正確であることを確認します。
• 出力: { tests_pass: boolean, server_ok: boolean, checklist_accurate: boolean }
• ゲート: 状態が検証された

フェーズ 5: 配信

サブエージェント: ResumeNotifier (モデル: haiku)

• ツール: Read
• プロンプト: 再開状態をユーザーに通知します。出力: すでに完了したもの、残っているもの、現在の開始地点、推定スコープ。
• 出力: { status_message, done_count, remaining_count, current_task, resume_ready: boolean }
• ゲート: ユーザーが通知され、かつ続行する準備ができた

---

状態ファイルの場所

ファイル	目的
.claude/local/state/<skill>-state.json	予備保存状態（障害復旧）
.claude/local/checklists/*.md	チェックリスト進行状況（TODO/DONE/SKIP/BLOCKED）
.claude/local/feedback-queue.md	まだ対応されていないライブフィードバック項目
.claude/local/cost-log.md	クレジット使用履歴
docs/CONFIDENCE_SCORE.md	以前の作業からの証拠と信頼度
CHANGELOG.md	すでに変更されたもの

---

再開シナリオ

ノートパソコンのスリープ後

1. チェックリストを読み込む → DONE/TODO をカウント
2. git status → コミットされていない作業をチェック
3. npm test → 既存の作業が成功することを確認
4. 必要に応じてサーバーを起動
5. 最初の TODO から再開
6. 出力: "再開中。N 完了、M 残り。開始: [項目]"

レート制限一時停止後

1. .claude/local/state/<skill>-state.json を読み込む
2. 一時停止した正確な項目とフェーズを読み込む
3. レート制限が解除されているかチェック（小さな API 呼び出しを試行）
4. まだ制限中 → ユーザーに通知、待機
5. 解除済み → 保存した正確なフェーズと項目から再開
6. 出力: "レート制限クリア。項目 N、フェーズ P から再開中。"

クレジット枯渇後

1. 保存された状態を読み込む
2. 完了したもの、残っているものを出力
3. ユーザーに確認: 「続行しますか？追加クレジットを使用します。」
4. はい → 保存ポイントから再開
5. いいえ → 完全な状態を出力して保存

セッションタイムアウト後

1. ノートパソコンのスリープと同じ
2. 最近のコミットについて git log をチェック（タイムアウト前にコミットされたかもしれません）
3. コミットされていない部分的な編集がないことを確認
4. チェックリスト状態から再開

---

古い項目の検出

完了した項目は以下の場合、古い（STALE）です：

• 変更したファイルが DONE マークされた後に変更されている
• git diff でファイルに新しい変更がある
• 別の項目またはホットフィックスが同じファイルに触れている

古い場合:

• ステータスを DONE → TODO に変更
• npm test で再検証
• テストが成功 → ステータスを DONE に戻す
• テストが失敗 → TODO のままにして、順序に従い修正

---

ユーザーメッセージ

クリーン再開（すべて問題なし）

お帰りなさい。前回の進行状況をチェック中です...
- チェックリスト: N/M 項目完了
- テスト: すべてパス
- サーバー: [現在起動中 | 不要]
再開元: [項目説明]

問題がある再開

お帰りなさい。いくつか問題が見つかりました:
- [コミットされていない変更が 2 ファイル — コミットか廃棄か？]
- [古い項目 1 件が再検証が必要]
- [サーバーがダウンしていた — 再起動中]
解決後: 項目 N から再開します。

再開する内容がない

保存された状態がありません。新たに開始します。
何に取り組みたいですか？

---

障害テーブル

障害	対応	最大リトライ数
状態ファイルが破損	状態を無視、チェックリストから再開	0
チェックリスト欠落	新たに開始、ユーザーにタスクを確認	0
npm test が既存作業で失敗	失敗テストを修正してから再開	2
サーバーが起動しない	server-lifecycle を呼び出し	1
コミットされていない作業が競合	ユーザーに確認: コミット、stash、または廃棄	0

---

低コストモデルのガードレール

• 状態ファイルはセッション開始時に 1 回読み込む — セッション中に再読み込みしない
• STALE でない限り完了項目をやり直さない
• npm test を 1 回実行して検証 — 項目ごとに実行しない
• コミットされていない作業についてユーザーに確認 — 自動決定しない
• 再開フロー全体で最大 8 ツール呼び出し
• 再開後: 元のスキルのフェーズ 3 に引き継ぎ、フェーズ 1 から再開しない