SuperAPI AI 工具集

simready-foundation-add-requirement

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

用途:在既有 SimReady 能力(capability)中新增一条原子化、可测试的需求(requirement)。需求是特性可引用、校验器可报告的最小稳定契约。若没有合适的能力承载,应先用 simready-foundation-add-capability;若新需求改变既有规则的行为,应改用 simready-foundation-update-requirement。

主要能力与产出:新增 requirements/<requirement_slug>.md,采用仓库需求元数据表风格(Code、Validator、Compatibility、Tags),并包含 Summary、Description、Why、Examples、How to comply 及相关 USD 或运行时引用;提供最小可用的有效与无效示例;把需求文件名加入 capability 的 requirements.md toctree 或需求表,必要时同步更新 capability-<slug>.md;输出变更文件、校验结果与遗留缺口。

必要前置阅读:AGENTS.md、nv_core/sr_specs/docs/guides/guides.md、features/features.md、features_expansion_workflow.md、naming_conventions.md,以及目标 capability 的 capability-.md、requirements.md、已有 requirements/.md 和 validation.py。

输入项:capability_path、requirement_slug(kebab-case,无 .md)、requirement_code(如 RB.011、NVM.006,且不得重复)、summary、description、compatibility(OpenUSD、PhysX、Isaac Sim、MDL 等)、tags、examples、validator_plan。

使用方式:确认目标能力存在且需求代码在所有层级能力来源中未被占用;创建需求文档;补索引与概述;若规则可客观实现,交接 simready-foundation-add-validator;若某特性应包含该需求,交接 simready-foundation-add-feature 或 simready-foundation-update-feature;最后校验代码唯一、索引可达、示例与规则一致、校验状态如实。

限制:需求须保持原子性,复合规则应拆分为多个 ID;不得仅为镜像特性名而创建需求;优先使用原生 USD 概念;新增自定义 USD 属性须遵守命名规范;主观指引用警告或人工审查,失败仅用于客观契约违例;在校验状态明确前不得把需求列入特性;不得就地修改已发布的特性或 profile 版本;契约不明确时不得编造 ID 或校验行为,应记录问题;不得跳过索引、清单、校验与下游交接说明。若概念与既有产物重叠,应更新既有 artifact;命名或 ID 冲突需先复查命名规范与邻近索引。