SuperAPI AI 工具集

simready-foundation-update-requirement

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

用途:修订已有 SimReady 需求(requirement),在编辑前区分编辑性澄清与契约变更;需求 ID 稳定,不得随意复用。若变更影响验证或特性一致性,需更新依赖的验证器并按需创建新的 feature/profile 版本。

前置阅读:AGENTS.md、nv_core/sr_specs/docs/guides/features/features.md、features_expansion_workflow.md、naming_conventions.md、目标需求 markdown、capability requirements.md、capability-*.md、validation.py、包含该需求代码的 feature JSON 清单,以及消费这些 feature 的 profile 版本。

输入:requirement_code(已有稳定 ID)、requirement_doc(待更新 markdown 路径)、change_type(编辑、示例澄清、兼容/标签更新、验证器对齐或契约变更)、reason、validator_change(是否需改 validation.py)、feature_impact(包含该需求的 feature 清单)。

步骤:在文档、验证器、feature JSON 与 profile 上下文中定位需求代码;分类变更(编辑性 vs 影响契约);除非用户明确要求弃用替换,保留需求代码;更新 markdown 的摘要、描述、示例与合规文本;保持元数据表与标准章节(Code、Validator、Compatibility、Tags、Summary、Description、Why、Examples、How to comply)与命名约定一致;验证器行为过时则交由 simready-foundation-update-validator;契约变更则交由 simready-foundation-update-feature 以升级依赖 feature 版本,不得仅靠文档静默改变已发布 feature 行为;仅当标题、slug 或需求组织变化时更新 capability 索引/概览;最后校验需求代码与验证器注册一致、示例与验证器行为一致、feature 清单仍合理、必要的 feature/profile 版本跟进已记录。

策略:不得将需求代码挪作他用;不得在未更新文档与 feature 版本影响的情况下收紧或放宽验证器;已发布需求有误时优先新增替代需求与新 feature 版本,而非就地改语义;示例保持可执行外观且精简。

限制:不得静默更改已发布契约,行为变化须加版本;不得在未检查验证器、清单、profile、适配器与运行时测试影响的情况下改文档;不得超出所选需求、能力、feature、profile、验证器或适配器范围。

排错:若变更改动已发布契约,创建新版本并保留旧产物;若文档与机器可读清单不一致,使 JSON/TOML 与 markdown 一致后重跑聚焦检查;若下游 profile 或适配器影响不明,先列出受影响产物再大范围编辑。

资源:assets/openai.yaml 为可选 UI 元数据,工作流不依赖。

汇报格式:requirement_code、change_type、docs_changed、validator_followup、feature_followup、profile_followup、validation。