用途:该技能是内部共享技能,作为完成与验证声明的新鲜证据门槛的唯一事实来源。宿主需在依赖中声明它(直接声明或经由 staged-review-flow),缺失时应中止,不做静默回退。名称说明:有意不命名为 verification-before-completion(该名称被外部技能仓库占用),仅使用本名称。
核心规则:没有来自当前轮次的新鲜证据,不得作出完成或通过声明。新鲜指由本轮助手执行命令、检查或观察到的工具结果产生(或同一轮次附带的日志);非新鲜包括上一轮记忆、“我们设计了测试”、仅子代理成功文本、假定 CI 为绿。
必要行为:当准备声称测试通过、类型检查/构建正常、验证完成、缺陷已修复、可合并或归档时,须在本轮运行相关命令或检查;否则标注为 Pending 并写明仍需执行的具体手动操作,且不得说它已通过。若检查打开了 UI,新鲜证据须包含本轮保存的非空 png、jpg、jpeg 或 webp 的文件系统路径;仅有路径而无该文件不支持通过声明。未打开 UI 的检查不要求图片。
与 staged-review-flow 的验证诚实性组合:Executed 表示本轮命令/操作及简要输出摘要;Pending 表示用户或后续轮次仍需执行的具体操作。禁止:本轮未运行验证命令却报告“全绿”或“已验证”;把设计好的场景或未检查的断言当作已执行的通过;在本仓库内将本技能重命名或别名为 verification-before-completion。
集成指南:宿主在验证或收尾处用一行指针加载本技能,不要粘贴核心规则原文;staged-review-flow 的诚实规则必须与本门槛组合(Executed ⇒ 新鲜证据)。本技能与 runtime-verification-discipline 正交:本技能把关证据新鲜度(本轮是否运行),后者把关验证环境与执行者(哪一层、谁运行、是否充分);通过声明须同时满足两者。建议设为用户不可直接调用(user-invocable: false),用户通过 PDCA 宿主触达。