SuperAPI AI 工具集

simready-foundation-conform-fet-001-standard

智能体与模型

查看项目

更新于 10-16 07:24

技能介绍

用途:这是 SimReady Foundation 的写作与修复类技能,在 FET_000_STANDARD 已通过、下一道验证关卡为 FET_001_STANDARD 时使用,把已有 USD 资产修到 Minimal/Standard 功能契约,同时保留视觉比例、层级意图和来源可追溯性。它不是最终验证器,而是修复流程的一环。

主要能力:按选定清单逐项修复需求 ID,顺序为原子资产/文件修复(AA.001、AA.002)、层级修复(HI.001、HI.003、HI.004)、单位与朝向修复(UN.001、UN.002、UN.006、UN.007)、最小可视几何修复(VG.001 或 VG.MESH.001)、网格质量修复(VG.002、VG.008、VG.014、VG.027、VG.028、VG.029),以及在放置约定明确时的原点定位修复(VG.025)。只修复所选清单中存在的需求,不在本技能中处理后续 profile 特性。

版本选择:默认使用最新签入版本 FET_001_STANDARD@1.0.1;仅在用户、profile、验证报告或迁移任务明确指定时才用较早契约。旧版报告需先映射:0.1.0→1,1.0.0→2,1.0.1→3。权威清单位于 nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/ 下的 FET_001_STANDARD-0.1.0.json、-1.0.0.json、-1.0.1.json 与 FET_001_STANDARD.md。

使用方式:先确认输入资产存在且 FET_000_STANDARD 已通过,否则交回 simready-foundation-conform-fet-000-standard。收集 usd_asset、output_root、simready_profile、profile_version、fet001_version、validation_report、source_asset、physical_size_policy 等输入,在 output_root 下创建暂存副本,不修改源资产。解析验证报告并过滤 FET_001_STANDARD 失败项,逐阶段应用确定性修复,然后重跑相同 profile 验证关卡或窄范围 FET_001_STANDARD 验证关卡。若可用,使用 uv run --python 3.12 validate-usd-minimum <staged-usd> --report <output-root>/minimum-usd-after-fet001.json 和 uv run --python 3.12 validate-simready-profile <staged-usd> --profile <profile> --profile-version <version> --foundation-root <simready-foundation-root> --foundation-spec-root <simready-foundation-root>/nv_core/sr_specs/docs --report <output-root>/simready-profile-after-fet001.json。

单位修复策略:默认保持物理尺寸。记录原始 metersPerUnit、组合边界、默认图元和根变换;毫米单位(metersPerUnit=0.001)需按 0.001 缩放或等效根缩放归一化到米;重算边界并校验米制边界在容差内不变。优先顺序为:从转换器以米单位重新导出、重缩放暂存 USD 数据、在同一暂存 USD 中应用根缩放归一化、创建米制包装、仅改元数据。metersPerUnit=0.001 的单文件保尺寸修复可设 metersPerUnit=1.0 并添加根 op xformOp:scale:meter_normalization=(0.001,0.001,0.001),前提是根变换可安全修改。

限制:不静默改动源资产;不隐藏所选特性关卡之后的 profile 失败;不虚构与资产意图冲突的几何、元数据或运行时行为。当失败来自需上游转换的缺失或非网格几何、不支持的文件类型、无法推断的绕序/法线/原点,或需编辑未随资产暂存的图层时,应阻止并报告而非猜测。验证工具不可用时,运行可用的最窄 USD 或静态检查并报告缺口。成功标准为 FET_001_STANDARD 通过,即使完整 profile 仍因刚体、多体物理或抓取向量等后续特性失败,也应把剩余失败作为交接工作报告。