用途:维护已存在的 SimReady Foundation 能力文件夹,包括添加需求条目、说明能力总览、重整需求文档,并保持验证器与导入对齐。若能力文件夹不存在,应改用 simready-foundation-add-capability。
使用前需阅读 AGENTS.md、nv_core/sr_specs/docs/guides/naming_conventions.md、目标 capability-.md、requirements.md、requirements/.md、validation.py,以及引用了本能力需求的 feature 清单。
输入包括 capability_path(已有能力文件夹)、change_type(添加需求、重整文档、更新范围、验证器注册或清理)、requirement_changes、validator_changes 和 feature_impact。
主要步骤:确认能力文件夹与总览/索引文件存在;将变更分类为仅文档、需求索引、验证器或契约影响;范围、需求列表、相关文档或验证状态变化时更新 capability-<slug>.md;更新 requirements.md 使每份需求文档恰好出现一次;按 add-requirement 或 update-requirement 技能指引添加或移动需求文档;仅在可执行验证器或导入变化时更新 validation.py 与 capabilities/init.py;需求语义变化时交由 feature/profile 更新技能处理。最后校验一致性:每份需求文档都被索引、每个被索引文件都存在、验证器注册引用已记录的需求 ID、feature 不引用已删除或重命名的需求 ID。
限制:不要静默更改已发布的契约,行为变化需新增版本;更新文档时须检查验证器、清单、profile、适配器和运行时测试影响;不要超出所选需求、能力、feature、profile、验证器或适配器的范围。若变更涉及已发布契约,应新建版本并保留旧产物;文档与机器可读清单不一致时,使 JSON/TOML 与 Markdown 一致并重跑聚焦检查;下游 profile 或适配器影响不明时,先列出受影响产物再广泛修改。assets/openai.yaml 仅保留可选 UI 元数据,工作流不依赖它。报告字段包括 capability_path、docs_changed、validators_changed、requirements_added、requirements_moved、feature_followup、validation。