完成层级
Evidence Level也常被叫作:现实层级做到哪一层完成度
「他说跑通了,我说没好,我们到底在说同一件事吗?」
完成层级 Evidence Level
同一句「做完了」可能站在六个完全不同的层上,说清是哪一层,争吵就消失了。
六层:概念 → 实现 → 测试 → 运行时 → 主路径 → 生产。
概念是「说清了要做什么」;实现是「代码写完了」;测试是「有自动检查通过」;运行时是「在本机真的跑起来了」;主路径是「真实用户的正常操作能走通」;生产是「线上有效,且能回滚、看得见问题」。
绝大多数「明明说好了却出事」,都是层级偷换:他在第 3 层说完成,你以为是第 6 层。两个人都没说错话,但对着不同的现实。
规则只有一条:能证明到第几层,就只说到第几层。 说低了不丢人,说高了会出事。而且层级不能跳——第 3 层的证据永远推不出第 5 层的结论,因为测试可以绕过真实入口,本机可以绕过线上环境。
这套尺子怎么用,比记住六层更重要。第一,先定目标层再开工。 改个文案,第 4 层(本机看到)就够;动数据库和线上,必须奔着第 6 层去。目标层决定你要投入多少验收力气,也决定你该要求 AI 交什么。第二,一层一层问「证据呢」。 他说「完成了」,你从第 1 层往上走:说清了没有?代码在哪?跑了没有?你亲自看到了吗?线上是新的吗?在哪一层断掉,你就知道这次交付的真实高度。第三,用层级给 AI 立规矩。 你在需求里先声明「这次要验到第 5 层」,它汇报时就会主动带着证据来,而不是先空口说完成。
这套尺子对你自己同样适用:对老板、对用户、对朋友说进度时,一句「代码写完了,还没在线上验」比一句「做完了」安全一百倍。说低一层不丢人,说高一层要还。
长什么样 真实可交互,不是截图
这六个格子值得记住。以后每次听到「完成」,先在心里指一下:他站在第几格?
拆开看,里面有这几块
-
1
概念 Concept
需求说清楚了,别人能复述。还没有任何东西在跑。
-
2
实现 Implementation
代码写完了,看得见改了哪些文件。没被验证过。
-
3
测试 Test
有自动检查通过。注意:测试可能绕过了真实入口。
-
4
运行时 Runtime
在本机真的跑起来了,你能亲眼看到结果。
-
5
主路径 Main path
真实用户的正常操作能走通,不靠特殊参数、不改配置。
-
6
生产 Production
线上真实环境有效,有回滚方案,出问题看得见。
常见的有哪几种
每上一层都需要新的观察,不是新的措辞。
用在:他反复保证但拿不出新证据时
测试通过推不出线上可用,中间还有构建、部署、缓存。
用在:听到「测试过了所以没问题」时
改文案到第 4 层就够;动数据和钱必须到第 6 层。
用在:决定这次要不要全套验收
容易搞混?这样区分
覆盖率是第 3 层内部的一个数字,它再高也不会自动把你送到第 5 层。100% 覆盖的代码依然可以在真实入口下白屏。
什么时候用得上
问一句「这算到第几层」。用过一次之后,很多人会自己开始分层汇报。
同样有用。对老板说「代码写完了,还没在线上验」,比说「做完了」安全一百倍。
看清当前站在第几层,缺的那几层就是你上线前要补的证据。
你可以这样跟 AI 说
直接复制下面这段,把【】里的换成你的情况。它比一句「帮我加个 X」多说清楚了:改哪里、不许动啥、做完交什么。
以后你汇报进度时,请明确说明当前站在下面哪一层,并说明依据: 1 概念:需求说清了,还没动手 2 实现:代码写完了,没验证 3 测试:有自动检查通过(说明测的是哪条路径) 4 运行时:本机真的跑起来了(说明我怎么打开看) 5 主路径:真实用户的正常操作能走通 6 生产:线上有效,且有回滚方案 规则:能证明到第几层就只说到第几层,不要用低层证据宣称高层结果。说"第 2 层"完全可以接受,说"完成"但其实只到第 2 层不可以。
这段话的效果常常出乎意料:一旦要求分层,很多含糊的「已完成」会自动变成诚实的「第 2 层,还没跑过」。
它说「做好了」,你怎么自己验
这是本站的重头戏。AI 最会的不是写代码,是说「已完成」。这一条,它通常最多做到「概念」这层:只是说清了要做什么,还没有任何东西在跑。
要亲眼看到这些,才算数
- 把这次任务的目标层级先写下来:你要的是第 4 层还是第 6 层?
- 听到完成宣称时,逐层问一句「有什么证据」,看在哪一层断掉。
- 确认没有跳层:第 3 层的证据不要当第 5 层用。
- 改动越不可逆(钱、数据、删除、线上),要求的层级越高——这一条要在开工前就定。
它常这么糊弄你
- 「本地测试全部通过,可以上线了」——第 3 层直接跳到第 6 层,中间三层全部省略。
- 「代码已经写好了,功能就是好的」——第 2 层冒充第 5 层。代码存在不等于行为正确。
- 「我看了一下逻辑,应该没问题」——连第 2 层都没到,这是第 1 层的推理。
- 给出一堆截图但全是本机端口。看地址栏:localhost 是第 4 层,域名才可能是第 6 层。
这是一把尺子,本身停在「概念」层。但它是全站唯一一条:只要你开始用它量,其他所有验收都会变简单。
考考你 选一个你觉得对的
AI 说「单元测试全部通过,这个功能已经完成了」。它实际站在第几层?
自动测试属于第 3 层。它有价值,但它可以完全绕开真实入口:测试直接调函数,用户是点按钮。要到第 5 层,得有人从真实入口走一遍;要到第 6 层,还得加上线上环境、缓存和回滚。