omniverse-cad-to-simready

CAD から SimReady へ

使用するタイミング

ソースアセットから SimReady アセットまたはパッケージまでのエンドツーエンドのパイプラインには、このワークフロースキルを使用します。既存の変換、オーサリング、検証、適合性確認、レンダリング、パッケージ化のリファレンスを直接連携させます。単一のモノリシックなランナーコマンドで置き換えないでください。

このスキルはドキュメント主導であり、scripts/run.py は同梱されていません。また、リポジトリのチェックアウトに依存してはなりません。Shell が宣言されているのは、このワークフローが各リファレンスのインストール先ディレクトリから、インストール済みのステージリファレンススクリプトを直接呼び出すためです。モノリシックなランナーを追加してはなりません。

前提条件

• 再現性のあるセットアップには、まず preflight を使用してください。ローカルの上流リポジトリのチェックアウトをインストールまたは検証し、cad-to-simready-preflight.json マニフェストを書き込み、後続のリファレンス向けに PHYSICAL_AI_PREFLIGHT_MANIFEST と PHYSICAL_AI_REQUIRE_PREFLIGHT=1 をエクスポートします。
• Python 3.12 と uv（リポジトリの README.md に記載）。
• ローカルデプロイを実行する場合は Content Agents のモデルプロバイダーキーが必要です。すでに稼働しているエンドポイントを使用する場合は、明示的なエンドポイント変数と利用トークンが必要です。完全なリストは references/preflight/README.md を参照してください。
• Content Agents と OVRTX のステージには、Docker、NVIDIA Container Toolkit、NVIDIA GPU が必要です。
• ステージで上流スクリプトまたは仕様が必要な場合は、次の場所にローカルの上流リポジトリのチェックアウトが必要です。 ${OMNIVERSE_CAD_TO_SIMREADY_UPSTREAM_ROOT:-$HOME/.omniverse-cad-to-simready/upstreams}

最初のアクション

CAD／ソースアセットから SimReady への幅広いリクエストでは、ユーザーが変換のみ、検証のみ、またはマテリアル／物理特性の割り当てなしを明示的に求めていない限り、property_assignment_intent=run としてください。変換のみのリクエストでは、property_assignment_intent=skip を設定し、Content Agents をデプロイせず、convert-to-usd を実行します。変換が成功したら、生成された USD に対して validate-usd-minimum を実行してください。検証のみのリクエストでは、property_assignment_intent=skip を設定し、変換を再実行せずにユーザー提供の USD を検証してください。

コンバーター、検証、Content Agents、OVRTX、パッケージ化、または FET の各ステップの前に、preflight を実行するか、既存の PHYSICAL_AI_PREFLIGHT_MANIFEST を確認してください。これは依存関係のブートストラップとして扱い、ワークフローのルーティングには使用しないでください。変換のみ／検証のみのリクエストでは、--skip-content-agents を使用してください。

property_assignment_intent=run の場合は、ソースパスを確認して意図を解決した直後に、アセットコンテキストの調査、コンバーターの依存関係確認、変換、検証、適合性確認、レンダリング、パッケージ化、上流ソースのビルドより前に、Content Agents のサービスを確認またはデプロイしてください。明示的に指定された正常なエンドポイントはユーザー所有として扱います。それ以外の場合は deploy-content-agents を実行します。これにより、共有のスタンドアロン OVRTX レンダラーがデプロイされ、その後、Material、Physics、任意の Texture の各サービスコンテナが順番にデプロイされます。

手順

1. ソースアセットのパスが存在することを確認し、output_rootを解決して、リクエストをエンドツーエンド、変換のみ、検証のみ、またはパッケージングに分類します。
2. アセットの検査、コンバーターのプローブ、変換、検証、適合性確認、レンダリング、またはパッケージングを実行する前に、property_assignment_intentを解決します。
3. 選択したワークフローの対象に対してpreflightを実行します。ただし、準備完了状態のPHYSICAL_AI_PREFLIGHT_MANIFESTがすでに設定されている場合は除きます。後続のスクリプトを実行する前に、生成されたenvファイルを読み込みます。preflightは依存関係のセットアップのみとして扱います。依存関係チェックの対象を絞るために、指定された--source-asset、--source-format、または--conversion-toolsの値を使用する場合がありますが、実際の変換サポートはconvert-to-usdと上流のコンバーター参照によって判断します。
4. property_assignment_intent=runの場合は、まずContent Agentsサービスが利用可能であることを確認するか、デプロイします。認証情報が不足している場合やサービスが正常でない場合は、続行せずに処理を止めます。
5. references/workflow.mdとreferences/commands.mdを読み、現在のリクエストに必要なステージ参照のみを実行します。
6. Web検索が利用可能な場合、またはプロパティ割り当てを実行する場合は、元のソースアセットに対してidentify-asset-contextを実行します。
7. ソースをconvert-to-usdに渡します。入力が既存のUSDの場合は変換をスキップし、ソースパスを現在のUSDパスとして扱います。
8. 負荷の高い後続処理の前に、validate-usd-minimumを実行します。これは実行可能性のゲートとしてのみ扱います。metersPerUnit != 1.0などの単位やプロファイルの問題は記録しますが、プロパティ割り当てを実行する場合は、Content Agentsによる割り当ての前にsimready-conform-profile、FET001、その他のFET修復を実行しないでください。
9. リクエストされた場合、または必要な場合は、変換済みまたは最低限の検証に合格したUSDに対して、Content Agentsによるマテリアル、物理特性、および任意のテクスチャの割り当てを実行します。
10. プロパティ割り当ての後、最新のシミュレーションUSDパスに対してsimready-conform-profileを実行し、選択したFET修復レポートをすべて保持します。
11. 次の順序で検証ゲートを実行します：omni-asset-validate、omni-asset-validate-geometry、omni-asset-validate-physics、simready-validate。
12. simready-validateで修復可能な要件が報告された場合は、simready-conform-profileを再実行し、最新の編集済みUSDに対してプロファイル検証を再実行します。
13. プレビュー、サムネイル、または検査画像がリクエストされた場合は、ovrtx-render-serviceを実行します。パッケージ出力がリクエストされた場合は、次にassemble-package-sourceを実行し、最終USDとサムネイルからクリーンなdeliverable/パッケージソースを作成してから、そのdeliverableフォルダーのみを対象にnv-core-package-sampleとnv-core-package-sample-validationを実行します。
14. 最終USDパス、すべてのステージレポート、検証結果、再実行の理由、および次の作業を含む統合ワークフローレポートを出力します。

出力形式

Markdown形式で統合ワークフローレポートを出力し、ワークフローが構造化アーティファクトを生成する場合はJSONも含めます。全体のステータスはpassed、blocked、failed、またはneeds_rerunとして報告します。必須のMarkdownおよびJSONレポート項目については、references/workflow.mdを参照してください。

詳細な参照資料

現在のリクエストに必要な参照資料のみを読みます。

• references/preflight/README.md：再現可能なローカルセットアップ、マニフェスト／envの契約、ラッパー、デプロイのオプトアウト、およびガードレールの動作。
• references/workflow.md：入力、ソースのルーティング、詳細なワークフロー、検証ポリシー、出力レポートの項目、および次のステップ。
• references/commands.md：移植性のある具体的なスクリプトコマンドのパターン。
• references/assemble-package-source/README.md：2ゾーンのパッケージソース組み立て、ルートUSDの命名、サムネイルの配置、およびdeliverableのチェック。
• references/troubleshooting.md：症状／原因／修正の表、およびFET（GSP.001／RB.MB.001）の修復ルーティングの詳細。
• references/publishing-layout.md：このスキル独自のファイルツリーに関するfrontmatter互換性フィールドの注記とレイアウトの根拠。

公開レイアウトに関する注意事項

この製品リポジトリのスキルの信頼できる情報源として、skills/omniverse-cad-to-simready/ を使用してください。.agents/skills のシンボリックリンクは、ローカルエージェントによる agentskills.io 形式の検出に対応するためのエイリアスであり、入れ子になった references/ ツリーも意図的なものです。エイリアスの一覧、frontmatter フィールドの配置、フラット化のルールについては、references/publishing-layout.md を参照してください。

制限事項

• このワークフローは、既存の変換、プロパティ割り当て、適合性確認、検証、レンダリング、パッケージ化の各スキルを連携させます。これらを単一のモノリシックな実行コマンドに置き換えるものではありません。

トラブルシューティング

特定のステージまたは検証ゲートで失敗している場合に限り、references/troubleshooting.md を読んでください。症状／原因／修正の表と FET の修復先は、このファイルに記載されています。

厳守事項

• ローカルの上流ルート、コンバーターの実行ファイル、SimReady 検証ランタイム、OVRTX エンドポイント、Content Agents のサービス URL には、優先してプリフライトマニフェストを使用してください。PHYSICAL_AI_REQUIRE_PREFLIGHT=1 が設定されている場合は、マニフェストを回避して上流を直接検出してはいけません。
• プロパティ割り当てを実行する場合は、Content Agents の準備が整う前に、アセットの検査、コンバーターのプローブ、ローカルでの上流ビルド、変換、検証、適合性確認、レンダリング、パッケージ化を実行してはいけません。
• ステージ固有のインストール済み参照スクリプトを直接使用してください。単一の omniverse-cad-to-simready 実行コマンドを追加または呼び出してはいけません。
• ソース変換には convert-to-usd の参照を使用してください。CAD 形式やメッシュ形式に別のコンバーターを代用してはいけません。
• プロパティ割り当てには、Content Agents の参照を独立したアトミックな手順として使用してください。まずマテリアル、次に物理、テクスチャは要求された場合に限り適用します。
• プロパティ割り当てを実行する場合は、Content Agents より前に simready-conform-profile または FET ヘルパーを実行してはいけません。最小限の USD を最初に検証し、その変換済みで最小限の要件を満たす USD に対して Content Agents を実行してから、サービスが作成した最新の USD に FET の修復を適用してください。
• プロパティ割り当てを実行する場合は、Content Agents より前に simready-validate または SimReady プロファイル検証を実行してはいけません。サービス呼び出しより前に許可される検証ゲートは、基本的な USD の実行可能性チェックである validate-usd-minimum のみです。
• ユーザーがベストエフォートでの続行を明示的に求めた場合を除き、デプロイ、変換、プロパティ割り当て、適合性確認の各作成ゲートで最初に失敗した時点で停止してください。
• 有意義な USD アーティファクトが存在する場合は、検証で指摘事項が見つかっても停止してはいけません。残りの診断ゲートを続行し、結果に needs_rerun の印を付けてください。
• GSP.001 のプロファイル失敗を、分類されていない最終指摘事項として残してはいけません。上流の simready-foundation-conform-fet-005-simulate-grasp-physics に回してください。現在のエージェントがレンダリングを確認できない場合、または明示的な把持点がない場合は、視覚的証拠へのパス、または入力が不足している理由を添えて、FET005 の修復がブロックされていることを報告してください。
• 各ステージのレポートをすべて保持し、各レポートに記載された具体的な出力 USD パスを次のステージに渡してください。