automation-shape-routing

Automation Shape Routing

必要な証拠と制御を維持できる、最小の実行形態を選択します。このスキルはルーティングを行います。基盤の構築や起動は行いません。

順序に沿ったルーティングが機能するのは、各段階の運用コストが次の段階より確実に低いためです。最小の形態でタスクに必要な証拠と制御を本当に維持できるなら、より大きな形態では調整コストが増えるだけで、正確性が高まることはありません。

名前付きの失敗モード — 基盤ロマンス：判断軸が求めているからではなく、トポロジーが興味深いという理由で永続ワーカーへルーティングすることです。

アンチパターン：手間を省くため、ルーティングの一環として選んだ基盤を起動することです。是正策：1 行の判定を返し、担当者が自身の権限で起動できるようにします。

重要な制約

• **ルーティングのみ行い、基盤を起動しないでください。理由：**実行形態の選択は判断のステップですが、NTM、Agent Mail、Gas City の起動はランタイムの状態を変更し、別途オペレーターの権限が必要です。
• **証拠を維持できる最小の形態を優先してください。理由：**永続性と調整には復旧や所有権のコストが伴い、一度限りの作業ではそのコストを回収できません。
• **並行性を選ぶ前に書き込みスコープを分割してください。理由：**ワーカーのトポロジーを大きくしても、重複する本番環境への書き込みが安全になるわけではありません。

順にルーティングする

1. **成果物は 1 つですか？**インラインで実行します。独立した視点そのものが成果物である場合に限り、セッション内で小規模なフレッシュコンテキストのファンアウトを使用します。一度限りのタスクでは再利用可能な成果物を作成しないでください。
2. 再利用可能な逐次手順ですか？skill-builderを使用します。
3. 絶対に後退させてはならない制約ですか？operationalizeを経由してゲートにルーティングします。
4. **固定された型付き DAG で、ヘッドレスであり、アタッチやステアリングが不要ですか？**そのランタイムが明示的に選択され、利用可能な場合に限り、workflow-builderを使用します。
5. 呼び出し元が提供するパケットを扱う、永続的でアタッチ可能な役割ですか？agent-nativeを使用します。NTM はペインアダプターです。Agent Mail は、明示的に選択された稼働中のアクターのみを調整します。
6. **GC ネイティブの監督／ストアを備えた、クエストが永続するシティですか？**オペレーターが Gas City を明示的に選択した場合に限り、using-gcにルーティングします。GC は自動フォールバックでも、aoのランタイム列挙値でもありません。

判断軸

軸	軽量な選択肢	エスカレーションした選択肢
寿命	現在のターン	永続的／アタッチ可能なワーカー
トポロジー	単一ライターまたは限定的なファンアウト	永続的な役割グラフ
制御	実行中のステアリングなし	監視／微調整／置換
出力	単一の成果物	再利用可能なスキル／ワークフロー／ゲート
ストア	呼び出し元が所有するパケットセット	オペレーターが選択した GC クエストストア
競合	単一ライター	分割してから Agent Mail で予約

並列化が得るのは独立性であり、速度の保証ではありません。一度限りの作業、書き込みスコープが衝突する作業、または活用できる並行性のない逐次チェーンでは、永続的なオーケストレーションを拒否してください。

引き継ぎ

次のいずれか 1 つだけを返します。

• inlineまたはbounded-fanout
• skill-builder
• workflow-builder
• 永続的なペインが役立つ理由を明記したagent-native
• オペレーターによる明示的な選択を伴うusing-gc
• operationalize:gate

判断軸と担当者を明記して、そこで終了します。呼び出し元は担当者を別途呼び出せます。このルーターから委任先のワークフローをコピーしたり起動したりしないでください。

出力仕様

• 成果物ディレクトリ： stdout のみです。この振り分け判断ではファイルを作成しません。

• ファイル名の規則： ありません。振り分け判定の行を正確に 1 行出力します。

• シリアライズ／スキーマ形式： shape=<allowed-shape>; axis=<deciding-axis>; owner=<owning-skill>。Handoff に記載された形状のいずれかを使用します。

• オーナーのマッピング： inline と bounded-fanout は current-agent を使用します。 skill-builder、workflow-builder、agent-native、using-gc は同じ値をオーナーに使用します。 operationalize:gate は operationalize を使用します。

• バリデーターコマンド： 捕捉した $verdict が、宣言された形状／オーナーのマッピングに従った正確に 1 行であることを検証します。

  printf '%s\n' "$verdict" | awk '
    NR > 1 { extra = 1 }
    {
      valid = ($0 ~ /^shape=(inline|bounded-fanout); axis=[^;]+; owner=current-agent$/ ||
               $0 ~ /^shape=skill-builder; axis=[^;]+; owner=skill-builder$/ ||
               $0 ~ /^shape=workflow-builder; axis=[^;]+; owner=workflow-builder$/ ||
               $0 ~ /^shape=agent-native; axis=[^;]+; owner=agent-native$/ ||
               $0 ~ /^shape=using-gc; axis=[^;]+; owner=using-gc$/ ||
               $0 ~ /^shape=operationalize:gate; axis=[^;]+; owner=operationalize$/)
    }
    END { exit !(NR == 1 && !extra && valid) }
  '
  

• 後続への引き継ぎ： 名前が指定されたオーナーを呼び出さずに呼び出し元へ返します。inline と bounded-fanout は推奨される実行形態を示しますが、この振り分けスキルが実行を開始することは許可しません。

品質評価基準

• 判定では、許可された形状と判断軸がそれぞれ正確に 1 つ指定されています。
• 永続的なルートまたは都市型のルートでは、オペレーターによる明示的な選択が示されています。
• 並行ルートでは、本番環境への書き込み対象範囲が重複しないことが明記されています。
• ルーターはワークフローをコピーまたは開始せず、オーナーに委任しています。