用途:在精确的 FET_###_<RUNTIME> 功能名(带整数版本)之间,或在 profile 功能包之间,建立直接的资产变更路径。功能适配器位于 nv_core/cip_specs/asset_handler_modules/ 下,修改输出 USD stage,使资产从输入功能/profile 契约迁移到目标契约。仅在功能/profile 差异已知后使用;若无需 USD 变更,应记录无需适配器。
主要能力:比较源与目标 manifest,确认名称格式及整数版本,找出差异需求;判断是否需要直接适配器;创建或选择 asset handler 模块路径;添加带 @feature_adapter 元数据的 Python 适配器文件;实现 modify_stage(input_stage, output_stage),仅在需要时读取源 stage,确定性地变更输出 stage,保留无关已编写数据,完成后保存输出 stage;优先使用原生 USD schema 和邻近适配器的辅助模式。
使用方式:先阅读 AGENTS.md、feature_adapters.md、源/目标功能 manifest、源/目标 profile 版本及现有适配器。收集输入:input_feature_name、input_feature_version、output_feature_name、output_feature_version、profile_path(可选)、mutation、module_path、test_assets。按检查清单修改仓库,添加聚焦测试或人工验证说明,并更新适配器索引、导入或注册文件。
适用场景:SimReady 资产在功能或 profile 版本间迁移;profile 转换时每个功能差异均需直接适配器路径或有记录的阻塞项。
限制:不得用适配器掩盖无效源资产;不得就地修改源 stage;不得凭空编造需要用户意图或预测的属性值,除非适配器契约明确定义默认值;不得就地修改已发布的功能或 profile 版本;契约不明确时不得编造需求 ID 或验证器行为。
错误处理:新概念与现有工件重叠时,应更新现有能力/需求/功能/profile/适配器;名称或 ID 冲突时,重新检查命名约定与邻近索引;验证策略不明时,记录延迟验证及后续技能。
资源:assets/openai.yaml 保存可选的 UI 元数据,工作流不依赖它。