用途:在改动 SimReady 需求、能力、验证器、特性(feature)、配置档(profile)、适配器、运行时测试或相关技能后,执行一致性审计。它是审计技能而非修复技能,修复需使用针对性的新增/更新技能。
主要能力:按清单检查需求/能力(唯一编码、被能力索引、overview 与 requirements.md 一致、命名规范);验证器(注册已记录的需求 ID、失败信息针对具体需求、文档与行为一致、导入/注册路径更新);特性(JSON 清单可解析、名称用 FET_###_<RUNTIME>、版本为点分语义版本、文件名匹配、依赖存在且精确、无循环依赖、markdown 与 JSON 一致、模板章节完整、必要时更新 features.md 与依赖图、契约变更需有对应 conform 技能);配置档(TOML 可解析、版本保留、引用特性存在、markdown 与 TOML 一致);适配器(元数据引用存在、差异有适配路径或记录阻塞);运行时测试(改 Python 源码而非生成产物、测试位于 nv_core/tiers/<tier>/<test-package>/、独立测试用 simready_benchmark.tests、每个可报告测试有独立模块与 @test 注册、覆盖非运行时行为的单元测试);技能/布局(skills 为唯一来源、兼容链接保留、名称对齐)。
使用方式:先阅读 AGENTS.md、改动文件、相关指南、受影响的特性清单与配置档,以及涉及运行时证据时的 benchmark 文档;收集 changed_files、change_type、target_feature_profile、available_tools;运行 JSON/TOML 解析、Python 语法/导入检查、simready-validate(已安装时)、USD/PXR 或运行时测试(可用且相关时);按严重程度报告发现,附文件路径与下一步修复技能。
适用场景:SimReady 仓库中需求、验证器、特性、配置档、适配器、运行时测试或技能发生变更后的提交前审计。
限制:仅审计一致性,仅在用户要求时修复;不得把缺失运行时证据当作通过,需记录验证缺口;不得将带版本的 SimReady 产物折叠为可变就地编辑;不可用工具需明确说明哪些检查未运行;文档与验证器冲突时先确定权威契约;配置档 markdown 与 TOML 不一致时以 TOML 为准;已发布版本被就地修改需标记(除非明确为编辑性改动)。