Skip to main content

moai handoff ハンドオフレコード

更新 2026-09-28 2分で読めます GitHub で編集 ↗

moai handoff は auto-resume ハンドオフの pending レコードを管理します。セッション境界 (/clear) を越えて作業を継続するための paste-ready resume 本文を保存または消去します。保存されたレコードは handoff.mode: auto 設定時に次のセッション開始時に自動注入されます。moai handoff show はハーネス中立の再表示経路です。どのハーネスでセッションを開いても、レコードの本文をそのまま表示します。保存・消費の配管はコードレベルでハーネス中立です(REQ-HN-011)— Codex が起動したプロセスがレコードを保存し、Claude の clear-source セッションがそれを消費する流れは、隔離環境で LIVE 再現されています。ワークツリーへ入ると .codex/hooks.json がシードされますが、Codex がプロジェクトローカルのフックを読み込むかどうかはプロジェクトの信頼設定に依存し、シードされたワークツリーに対する LIVE 検証は行われていません。Codex アダプターは SessionStart の systemMessage を additionalContext に写し、コンテキストが既にあれば追記します。

サブコマンド

コマンド説明
moai handoff savepaste-ready resume 本文を pending レコードとして保存
moai handoff clearpending レコードを除去
moai handoff showpending レコードを消費せずにそのまま表示(消費履歴の最新レコードへフォールバック)

共通フラグとして --project-dir <path> (プロジェクトルート、デフォルト: 現在のディレクトリ) を受け取ります。

moai handoff save

bash
moai handoff save --stdin --spec SPEC-AUTH-001 --phase run < resume.txt
フラグ説明
--body <text>resume 本文 (verbatim 6-block paste-ready)
--stdin--body の代わりに stdin から本文を読み込む
--spec <id>このハンドオフが再開する SPEC id
--phase <plan|run|sync>フェーズ
--session <uuid>saved_by_session uuid (帰属)
--lang <lang>conversation_language のスナップショット
--ultrathinkultrathink 指示を記録 (復元案内用)
--ultracodeultracode 指示を記録 (復元案内用)
--goal <condition>/moai goal 条件を記録 (復元案内用)

moai handoff clear

bash
moai handoff clear

pending ハンドオフレコードを除去します。

moai handoff show

bash
moai handoff show [--json]

pending ハンドオフレコードの本文を、状態を変えずにそのまま表示します。pending レコードがない場合は消費履歴の最新レコードへフォールバックします。--json はソース・SPEC id・フェーズ・本文を JSON で出力します。

Fail-open 保証

moai CLI が PATH に存在しない場合、または moai handoff save が non-zero で終了した場合でも、オーケストレーターの paste-ready 出力は変更されず維持されます。保存の失敗はハンドオフの出力を決して妨げず、手動 paste 経路は保存なしでも完全に機能します — 保存は付加的な永続化ステップであり、ゲートではありません。

関連ドキュメント