用途:verification-before-completion 是 Prodcraft 的跨阶段质量门,用于防止虚假的完成声明。它不替代各阶段自身的质量工作,而是在说“缺陷已修复”“阶段已完成”“测试通过”“发布就绪”“交接安全”之前做最后的诚实检查。快速通道可缩小验证范围,但不能豁免此门。
主要能力:要求先精确命名声明,再确定所需的新鲜证据,然后当场运行验证,检查产物与交接完整性,最后如实记录结果。它提供验证记录(verification-record)和可选的执行状态(execution-state)输出,并给出质量门清单与反模式提示,如乐观改写、代理验证、陈旧绿灯、快速通道漏洞、代理信任坠落。
使用方式:从当前声明和最强可用的验证命令、产物或清单开始。运行完整命令而非弱代理,读取实际输出与退出状态,确认预期产物存在,确认阶段门满足,并明确记录未验证区域。若项目采用严格执行循环,需将验证记录与证据快照绑定到当前完成尝试,并运行:python scripts/validate_prodcraft.py --authorize-execution-state .prodcraft/artifacts/<work_id>/execution-state.json --approved-route-digest sha256:<operator-pinned-route-digest> --approved-completion-digest sha256:<operator-pinned-completion-digest>。只有 terminal-authorized 才允许无保留的路线级完成声明;gate-authorized 是非终态进展授权。历史、非规范、缺失固定、陈旧工作或仅结构有效的结果都会阻止声明。验证记录实例可运行:python scripts/validate_prodcraft.py --artifact-instance <path-to-verification-record.json>。产物实例在存在 .prodcraft/artifacts/ 时存放于该目录,否则写入最近的证据或交接目录并在交接中记录路径。
适用场景:修复、阶段完成、测试通过、发布就绪、交接安全、事件解决等完成声明前的最终检查。
限制:不替代阶段本地质量工作;快速通道不豁免证据;不能依赖陈旧运行、部分检查或“应该还是绿的”;不能凭上下文或对话历史假设文件已修改或任务已完成;无法通过 diff、cat 或目录列表看到变更时,证据缺失,验证必须失败。安装与分发:公共安装面为 skills/.curated,规范源为 skills/cross-cutting/verification-before-completion/SKILL.md,兼容 npx skills add/update,打包稳定性 beta,能力就绪度 core。