用途:当 SimReady 验证器已存在但过时、错误、不完整、过严、过松或与需求文档不同步时,使用本技能进行更新。若修改验证器行为会改变契约,应协调需求与功能版本更新,而不是静默改变已发布的验证语义。
主要能力:更新验证器类/函数、失败消息、边界情况与测试;区分缺陷修复(实现未匹配既有需求)与契约变更(期望行为不同于文档化需求);对缺陷修复直接修补验证器与测试/样本;对契约变更先更新需求文档并创建新的功能/配置版本。
使用方式:编辑前先阅读 AGENTS.md、目标 validation.py、检查器中每个已注册需求的需求文档、包含这些需求的功能清单与配置,以及现有测试或样本资产。收集或推断 checker、requirement_codes、bug_or_gap、contract_impact、test_evidence。按清单操作:复现或检查报告的行为;将验证器逻辑与需求文档及功能清单用法对比;分类变更;修补;保持失败消息稳定,除非其不清晰或错误;保留既有有效边界情况,除非需求明确变更;验证聚焦的通过/失败资产或测试、导入/语法检查,以及受影响的功能/配置验证。
适用场景:SimReady 验证器维护、失败消息修正、边界情况补充、测试更新、需求文档漂移修复。
限制:不得扩大验证器以覆盖未文档化的需求;不得在未解释需求为何允许该情况时移除失败;除修复与文档的明显不匹配外,避免更改注册 ID;若工具不可用,报告确切环境缺口与已执行的更窄检查;不得静默更改已发布契约,行为变更时需新增版本;不得在未检查验证器、清单、配置、适配器与运行时测试影响的情况下更新文档;不得将变更扩大到所选需求、能力、功能、配置、验证器或适配器之外。资源 assets/openai.yaml 保留可选 UI 元数据,非工作流必需。