moai handoff ハンドオフレコード
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 save | paste-ready resume 本文を pending レコードとして保存 |
moai handoff clear | pending レコードを除去 |
moai handoff show | pending レコードを消費せずにそのまま表示(消費履歴の最新レコードへフォールバック) |
共通フラグとして --project-dir <path> (プロジェクトルート、デフォルト: 現在のディレクトリ) を受け取ります。
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 のスナップショット |
--ultrathink | ultrathink 指示を記録 (復元案内用) |
--ultracode | ultracode 指示を記録 (復元案内用) |
--goal <condition> | /moai goal 条件を記録 (復元案内用) |
moai handoff clearpending ハンドオフレコードを除去します。
moai handoff show [--json]pending ハンドオフレコードの本文を、状態を変えずにそのまま表示します。pending レコードがない場合は消費履歴の最新レコードへフォールバックします。--json はソース・SPEC id・フェーズ・本文を JSON で出力します。
moai CLI が PATH に存在しない場合、または moai handoff save が non-zero で終了した場合でも、オーケストレーターの paste-ready 出力は変更されず維持されます。保存の失敗はハンドオフの出力を決して妨げず、手動 paste 経路は保存なしでも完全に機能します — 保存は付加的な永続化ステップであり、ゲートではありません。