mcpField
R
resume-session

resume-session

github.com/q00エージェントワークフロー6.3k52 回インストール今日更新
リポジトリ

resume-session について

MCP サーバーの予期しない切断後に、進行中のセッションを探す Ouroboros スキルです。実行中または一時停止中のセッションを読み取り専用で一覧表示し、確認や再開のコマンドを案内します。

主な機能

  1. 01実行中と一時停止中のセッションを一覧表示
  2. 02EventStore を読み取り専用で参照
  3. 03直近のセッションまたは全件を表示
  4. 04確認と再開のコマンドを提示

活用シーン

  1. 01MCP サーバー切断後にセッションの状況を把握
  2. 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

手順

  1. アクティブなランタイムの run_shell 機能を使って実行します。

    ouroboros resume --list
    

    設定済みの EventStore を直接、読み取り専用で読み込み(MCP サーバーは不要で、作成も書き込みも行いません)、running または paused のセッションを一覧表示します。直近20件を表示するか、--all を指定してすべて表示します。--list はテーブルを表示して終了します。対話型プロンプトは、ターミナルが接続されていない場合に中断されるためです。終了コード2は、EventStore は存在するものの読み取れなかったことを示します。

  2. セッションが一覧表示されたら、テーブルを表示し、どのセッションを対象にするか尋ねます(アクティブなランタイムの ask_user 機能を使用します)。各行には、以下で使用する session_id、exec_id、Seed ID が含まれています。

  3. 該当する再接続方法を案内します。

    • 永続化されたイベントを確認する(読み取り専用、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> を実行します。

「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個の選択肢を列挙してください。

コメント