サブエージェントの返信は完了レシートではない：オーケストレーター検証チェックリスト

OpenClawのsessions_spawnはノンブロッキングです。作業が完了したときではなく、受け入れられたときにrunIdと子セッションを返します。親は部分的な出力を受け取り、それを要約して成功を報告する一方で、別の子がまだ実行中、失敗、または失われている可能性があります。

重要な詳細

• sessions_yieldは、完了イベントを待つための文書化された方法です。
• タスクフローは、複数ステップの作業を個々のバックグラウンドタスクのレコードにリンクし、永続的なワークフローを実現します。
• 親を完了させる前に、必要なすべての子を調整します。

調整チェックリスト

ソースは、子ごとに次のフィールドを追跡することを推奨しています。

parent_run_id
child_run_id
terminal_state
verification_receipt
completion_blocker

欠落または矛盾する状態は、成功ではなくincomplete_reconciliationを生成する必要があります。失敗、キャンセル、または失われた子は、部分的な結果やブロックされた結果を正当化する場合がありますが、証拠がある場合に限ります。

自分でテストする

無害な子を3つ生成します。

1. 成功するもの。
2. 部分的な出力を返してから失敗するもの。
3. 保留中のままのもの。

親は、すべての子が信頼できる終了状態を持ち、必要な検証が完了するまで、成功を拒否する必要があります。

要点

オーケストレーターを信頼する前に、自問してください：すべての子の実行を検証していますか、それとも単に受け取った返信を数えているだけですか？