agent-session-resume

エージェントセッションの再開

目的

継続性を保ちながら、以前のコーディングエージェントの作業を再開または監査します。行動する前に、それまでの経緯を再構築し、実際に中断した地点から続けます。

基本的なワークフロー

1. 来歴をセルフチェックします。

   • 利用可能な場合は、python3 skills/agent-session-resume/scripts/skill-provenance.py を実行します。
   • 利用できない場合は、読み込まれた SKILL.md のパスとサイズを、$HOME/.claude および ${CODEX_HOME:-$HOME/.codex} 以下の既知のインストール先と比較します。
   • 再開レポートの Loaded skill 行に古さを記載します。詳細は references/evidence-and-provenance.md を参照してください。

2. ソースを特定します。ユーザーがプラットフォームを指定した場合は、references/ 内の該当ファイルを読みます。依頼が複数のプラットフォームにまたがる場合は、references/cross-platform.md を読みます。それ以外の場合は、ワークスペース内でセッションフォルダー、エクスポート、要約、成果物を調べます。セッションのタイトルが指定されている場合は、直近のものよりも、タイトルが完全一致または部分一致するものを優先します。

3. トランスクリプトまたは最良の代替資料を特定します。要約より完全なトランスクリプトを、グローバルな履歴よりワークスペース内のセッションデータを優先し、見つかったパスよりユーザーが明示したパスを優先します。

4. 行動する前に、利用可能なセッション記録をすべて読みます。トランスクリプトが大きい場合は、まずファイル、イベントの種類、タイムスタンプを一覧にし、その後、記録全体を把握できるまで証拠となる部分を読みます。全体を把握するとは、関連する証拠を見落とさないことです。巨大な記録では、範囲を絞った検索や部分ごとの確認でも構いませんが、その場合は範囲を限定したことと、対象ファイルまたはイベントを明記します。この確認が完了する前に、ファイルを編集したり、以前の作業を繰り返したりしないでください。

5. レポートに読み込まれたスキルの来歴を記録します。パスとソース／バージョンの識別子、または unknown を記載し、推測で埋めてはいけません。詳細は references/evidence-and-provenance.md を参照してください。

6. コンテキストを再構築します。目標、判断、制約、好みを要約し、完了した作業、変更したファイル、実行したコマンドとテストを特定し、正確な中断地点を示します。作業状況に関する各記述には、根拠の参照先（src/file.ts:L20-L35、トランスクリプトの行、コマンド出力、または明示的に「未確認」）を付けます。以前の再開レポート、要約、引き継ぎにある記述は一次証拠ではありません。トランスクリプト、ファイル、Git の状態、コマンド出力と照合して再確認するか、未検証であることを明記します。明示的に延期された作業（「スキップ」「保留」「今はしない」「一時停止」）は、根拠、対象範囲、再開条件とともに保持します。

7. タスクを抽出します。明示的な TODO、計画、未解決の質問を記録します。失敗したテスト、未完了の編集、「次のステップ」に関する記述から、暗黙のタスクも推定します。未完了のタスクは具体的な内容を保ちます。延期された作業は NOT DONE と分けて管理します。次のように分類します。DONE（完了して検証済み、または不要になった）、PARTIALLY DONE（着手済みだが、実装、テスト、レビュー、コミット、プッシュ、確認のいずれかが未完了）、NOT DONE（未着手、または話し合われただけ）。

8. ワークスペースと照合します。編集前に Git の状態を確認し、チェックポイントでその結果を記載します。以前のセッションで触れたファイルを読みます。作業ツリーに未コミットのユーザー変更がある場合は保持し、競合する作業には別のワークツリーを使うか、作業前に確認します。トランスクリプトの記述が現在のファイルと矛盾する場合は、現在のファイルを優先し、その不一致を報告します。

9. 最初の未完了ステップから続けます。完了した作業を繰り返さず、明らかな問題がない限り、確立された進め方とスタイルに従います。必要な情報が不足している場合、または安全でない選択を迫られる場合に限り、ユーザーに確認します。

再開モード

チェックポイントの後にどこまで進めるかを、ユーザーの依頼から判断します。

• Report-only：過去の作業内容、完了事項と保留事項の確認、または以前のセッションのチェック／監査／レビューを求められている場合です。再開レポートと明確な次のアクションを示したところで終了します。
• Continue-edit：続行、修正、実装、PR の作成、またはテストの実行を求められている場合です。まずレポートを提示し、その後、安全に実行できる最初の未完了ステップから続けます。
• Quick resume：状況報告やタスクの整理を求められている場合です。簡潔なソース一覧、タスクの分類、次のアクションを優先します。
• Deep resume：実装を続行する場合、ソースが不明確な場合、またはファイルに変更が加わっている可能性がある場合です。記録全体と現在の Git の状態を確認してから続けます。

プラットフォーム別リファレンス

• Claude Code：references/claude-code.md
• Codex：references/codex.md
• Cursor：references/cursor.md
• Antigravity：references/antigravity.md
• OpenCode：references/opencode.md
• GitHub Copilot：references/github-copilot.md
• クロスプラットフォーム／マルチエージェントに関する依頼：references/cross-platform.md

必須の応答形式

実行を続ける前に、次の内容を報告してください。

## Brief context summary

- Goal: <prior session goal>
- Loaded skill: path=<loaded SKILL.md path or "unknown">; source/version=<version marker or "unknown">
- Source reviewed: <transcript/export/artifact refs>
- Current workspace check: <git status summary and touched-file refs, or why not checked>
- Transcript/current repo mismatches: <none found | claim, transcript ref, current-repo ref, action>
- User deferrals: <none found | deferred scope, user wording, evidence ref, reopen condition>
- Stopping point: <last command, edit, failure, or user pause instruction with evidence>

## Task status breakdown

- DONE: <task> - evidence: <implementation refs>; verification: <test/tool refs or "not recorded">.
- PARTIALLY DONE: <task> - evidence: <started-work refs>; missing: <remaining gap refs>.
- NOT DONE: <task> - evidence: <TODO, failing test, absent artifact, or transcript gap refs>.

## Clear next action

- Next: <first unfinished step to take now>
- Blocked: <no | yes - reason and evidence>

その後、ブロックされていない限り、すぐに続行してください。エビデンスに関するルールと静的な冪等性の契約については、references/evidence-and-provenance.mdを参照してください。

ガードレール

• ユーザーがタイトルまたはパスを指定している場合、最新のファイルが正しいトランスクリプトだと決めつけないでください。
• ファイル名だけから要約したり、利用可能な完全なトランスクリプトと簡潔な要約を同等のものとして扱ったりしないでください。
• ユーザーから明示的に依頼されない限り、既存の変更をリセット、取り消し、破棄しないでください。
• 計画だけを根拠にタスクをDONEまたはPARTIALLY DONEにしないでください。ステータスには、完了または作業開始を示すエビデンスが必要です。
• トランスクリプトと確認済みのファイルが食い違う場合、その不一致を省略しないでください。
• 曖昧な「進めて」または「続けて」という指示を受けても、延期されたスコープを再開しないでください。その保留中の作業を再開するか、ユーザーに確認してください。