验不到的部分要显式记为未验证
一、现象
自动化验收跑通了它能看到的部分(六个一级入口的 iconLeft/textLeft 几何、侧栏宽度、文字不越界、暗色截图正常),但 runtime 对页面里的 React button 只聚焦、不派发状态变更,所以"实点展开/收起"和"切到浅色主题"这两项根本没执行。
正确处置:在 PR 验收说明和 Issue 评论里明确记录为 Browser runtime blocker,并声明"不要声称这两项通过"。
二、为什么必须显式
- 验收结论会被下游(评审人、用户、后续自动化)当作"已确认"。把未覆盖项混进"通过",等于发出一个假信号,等用户真机点到才发现。
- 未验证项通常恰好是交互类(点击、状态切换、主题)—— 也就是最容易坏、最该验的那一类。几何和静态截图正常,不代表交互正常。
三、可迁移的写法
任何验收报告分三栏,缺一栏就是信息缺失:
| 栏 | 内容 |
|---|---|
| 已验证 | 结论 + 证据(截图/日志/命令输出) |
| 未验证 | 项 + 为什么(工具/runtime blocker、环境缺失) |
| 失败 | 现象 + 证据 |
判据一句话:没有新鲜证据的项,写"未验证",不写"通过"。
相关
- 能力要靠消费方认账 —— 未验证项就是"还没被消费方认账"
- 判据要用真值而非代理 —— 用几何/截图代理交互行为,是代理量替代真值
- 全绿的单测可能测的不是那条链路 —— 同为"绿灯覆盖不到真实链路"
- Issue完成由用户验收后再关闭 —— 未验证项要留给用户验收
- 假成功要有真失败信号