SuperAPI AI 工具集

simready-foundation-add-validator

测试与质量

查看项目

更新于 10-16 02:34

技能介绍

用途:为 SimReady 的一个或多个需求 ID 实现客观验证,验证器需针对能力文档中记录的确切需求代码报告失败。若规则已存在但有误或不完整,应改用 simready-foundation-update-validator。

主要能力:在目标能力的 validation.py 中新增检查器类或函数,使用该能力既有的注册装饰器与导入方式;注册检查器所执行的每个需求 ID,并在报告失败时传入匹配的需求;保持失败信息具体、确定且可操作;按邻近验证器的方式一致处理缺失默认 prim、无效路径、未加载/抽象 prim、变体与组合阶段;在仓库有测试模式时添加聚焦的通过/失败测试或示例验证说明。

使用方式:编辑前先阅读 AGENTS.md、nv_core/sr_specs/docs/guides/features/features.md、features_expansion_workflow.md、naming_conventions.md、目标需求 markdown、目标能力的 validation.py、同能力内邻近检查器类以及包含该需求的 feature manifest。收集或推断 requirement_codes、validation_module、rule_name、asset_scope、failure_message、test_assets。按清单确认需求文档存在且检查客观,复用本地辅助模式,添加检查器并注册需求 ID,最后校验导入、需求 ID 与文档代码一致、失败信息与文档一致、feature manifest 仅含已注册需求。

适用场景:为 SimReady 工厂连接点等需求添加验证器;需要为需求提供可执行覆盖时。

限制:不得将主观指导作为硬失败验证,除非需求定义了客观标准;优先每个规则族一个清晰检查器;避免改动无关验证器;仅在框架支持且需求为建议性时使用警告;本地 Omniverse/OAV 包不可用时记录可运行的收窄验证;不得就地修改已发布 feature 或 profile 版本;契约不明确时不得编造需求 ID 或验证器行为,应记录问题;不得跳过索引、manifest、验证或下游跟进说明。资源 assets/openai.yaml 保留可选 UI 元数据,非工作流必需。