resume-session について
MCP サーバーの予期しない切断後に、進行中のセッションを探す Ouroboros スキルです。実行中または一時停止中のセッションを読み取り専用で一覧表示し、確認や再開のコマンドを案内します。
主な機能
- 01実行中と一時停止中のセッションを一覧表示
- 02EventStore を読み取り専用で参照
- 03直近のセッションまたは全件を表示
- 04確認と再開のコマンドを提示
活用シーン
- 01MCP サーバー切断後にセッションの状況を把握
- 02保存済みセッションを選んで確認または再開
MCP 対応
MCP サーバー切断後のセッション復旧を扱います。一覧表示は EventStore を直接読み取り、MCP サーバーを必要としません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ q00/ ouroboros --skill resume-sessionインストール後、Claude Code で/resume-sessionを入力して読み込まれたか確認します。
詳細
/ouroboros:resume-session
予期しない MCP サーバーの切断後に、進行中の Ouroboros セッションを復旧します。この名前は、Claude Code に組み込まれている /resume との名前の衝突を避けています。
ooo resume-session [--all]
/ouroboros:resume-session
手順
-
アクティブなランタイムの
run_shell機能を使って実行します。ouroboros resume --list設定済みの EventStore を直接、読み取り専用で読み込み(MCP サーバーは不要で、作成も書き込みも行いません)、
runningまたはpausedのセッションを一覧表示します。直近20件を表示するか、--allを指定してすべて表示します。--listはテーブルを表示して終了します。対話型プロンプトは、ターミナルが接続されていない場合に中断されるためです。終了コード2は、EventStore は存在するものの読み取れなかったことを示します。 -
セッションが一覧表示されたら、テーブルを表示し、どのセッションを対象にするか尋ねます(アクティブなランタイムの
ask_user機能を使用します)。各行には、以下で使用するsession_id、exec_id、Seed ID が含まれています。 -
該当する再接続方法を案内します。
- 永続化されたイベントを確認する(読み取り専用、MCP サーバー不要):
ouroboros status execution <exec_id> --events - 対話形式で確認する(読み取り専用のモニター。TUI でセッションを選択):
ouroboros tui monitor - 実行を再開する(元の Seed ファイルが必要です。
--resumeにはsession_idを指定します):ouroboros run workflow --orchestrator --resume <session_id> <seed.yaml>
その後、実行が完了したら
ooo evaluateを実行します。停止している場合はooo cancel <session_id>を実行します。 - 永続化されたイベントを確認する(読み取り専用、MCP サーバー不要):
「No in-flight sessions found」と表示された場合、実行は完了、失敗、またはキャンセルされているか、EventStore が作成されていません。過去のセッションを確認するには ouroboros tui monitor を使います。
RFC #1392 State Breadcrumb Footer
最終応答の末尾は、◆ <current state> → next: <recommended action> の1行だけにしてください。利用可能な場合は ouroboros_session_status からライブのセッション状態を取得し、そうでない場合はこのスキルの実際の結果から状態を判断します。Step N of M のような直線的なフッターは使用しないでください。次のステップに実際の選択肢がある場合は、2~3個の選択肢を列挙してください。