| 名称 | omniverse-cad-to-simready |
| 描述 | “协调从CAD/源资产到SimReady工作流的端到端流程。适用于需要转换、材质/物理属性分配、SimReady合规性验证以及可选包创建的广泛请求，例如CAD到SimReady、源资产到可仿真USD或道具打包；当启用属性分配时，请先部署或验证Content Agents服务；将单阶段工作路由到嵌套引用。” |
| 版本 | “0.2.0” |
| 开源协议 | Apache-2.0 tools: - Read - Shell allowed-tools: Read Write Bash WebFetch Env permissions: [env, file_read, file_write, network, shell] compatibility: > 编排器技能。托管Content Agents部署需要配置与所选后端匹配的模型提供程序密钥，例如NVIDIA_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY或GEMINI_API_KEY，以及Docker + NVIDIA Container Toolkit + GPU、Python 3.12和upstream-versions.lock.json中固定的ref对应的nvidia-omniverse/content-agents仓库检出。复用的/提供的端点可以使用显式的端点和临时令牌环境变量。仅适用于Linux/macOS。 metadata: |
| 作者 | Omniverse tags: - physical-ai - simready - workflow - cad - conversion domain: ai-ml languages: - python |
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服务容器。
说明
- 确认源资产路径存在，解析
output_root，并将请求分类为端到端、仅转换、仅验证或打包。 - 在任何资产检查、转换器探测、转换、验证、合规检查、渲染或打包步骤之前解析
property_assignment_intent。 - 为选定的工作流目标运行
preflight，除非已配置就绪的PHYSICAL_AI_PREFLIGHT_MANIFEST。在运行下游脚本之前先加载生成的env文件。将preflight仅视为依赖设置：它可以使用提供的--source-asset、--source-format或--conversion-tools值来限定依赖检查的范围，但convert-to-usd和上游转换器引用仍决定实际转换支持。 - 当
property_assignment_intent=run时，首先验证或部署Content Agents服务；如缺少身份验证或服务不健康，应阻塞而不是继续。 - 阅读
references/workflow.md和references/commands.md，然后仅运行当前请求所需的阶段引用。 - 当网页搜索可用或属性分配将运行时，对原始源资产运行
identify-asset-context。 - 将源资产路由到
convert-to-usd，或者对于现有USD输入跳过转换，并将源路径视为当前USD路径。 - 在昂贵的下游工作前运行
validate-usd-minimum。仅将其视为可行性门禁：记录单位/配置文件问题，例如metersPerUnit != 1.0，但当属性分配将运行时，不要在Content Agents分配前运行simready-conform-profile、FET001或任何其他FET修复。 - 在转换后的/最低有效USD上，按需或按必需运行Content Agents的材质、物理和可选纹理分配。
- 在属性分配后的最新模拟USD路径上运行
simready-conform-profile，并保留每个选定的FET修复报告。 - 按顺序运行验证门禁：
omni-asset-validate、omni-asset-validate-geometry、omni-asset-validate-physics和simready-validate。 - 当
simready-validate报告可修复的需求时，重新运行simready-conform-profile，然后在新编写的最新USD上重新运行配置文件验证。 - 当需要预览、缩略图或检查图像时，运行
ovrtx-render-service。当需要包输出时，接着运行assemble-package-source，从最终USD和缩略图创建干净的deliverable/包源，然后仅在该deliverable文件夹上运行nv-core-package-sample和nv-core-package-sample-validation。 - 发送合并的工作流报告，包含最终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：两区域包源组装、根USD命名、缩略图位置和交付检查。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修复路由。
硬性规则
- 优先使用preflight清单获取本地上游根、转换器可执行文件、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，再将FET修复应用于最新服务编写的USD。 - 当属性分配将运行时，不要在Content Agents前运行
simready-validate或任何SimReady配置文件验证。在服务调用前唯一允许的验证门禁是validate-usd-minimum，即基本的USD可行性检查。 - 在第一个失败的部署、转换、属性分配或合规编写门禁处停止，除非用户明确要求尽力继续。
- 在存在有意义的USD工件之后，不要因验证发现而停止。继续剩余的诊断门禁，并将结果标记为
needs_rerun。 - 不要把
GSP.001配置文件失败留作未分类的最终结论。将其路由到上游simready-foundation-conform-fet-005-simulate-grasp-physics；如果当前代理无法检查渲染或没有可用的显式抓取点，请使用视觉证据路径或缺失输入原因报告阻塞的FET005修复。 - 保留每个阶段报告，并将每个报告中的具体输出USD路径传递到下一阶段。