Skip to content

第 6 章 什么叫做完了 ​

第二部分 让 AI 把它做出来 · 正文初稿

这一章是初稿,还会修改。

做完三问

护栏

本章要回答 ​

每次改动都回答:改了什么、怎么验证、还有什么风险;老板要快、你要稳,怎么取舍;测试先保最贵的地方。

示例项目推进到哪 ​

给下单金额和状态流转加上测试。

读完这一章,你能对每一次改动回答三个问题:改了什么,怎么验证的,还有什么风险。你也能判断,赶时间的时候哪些地方可以先糙,哪些地方必须现在做对。落到餐厅后台上,就是给下单金额和订单状态加上测试,再亲手演示一遍真实流程。

老板要快,你要稳 ​

很多人以为老板喜欢速度快、漏洞多的系统。我的看法是,老板不喜欢漏洞,老板更怕慢。

慢本身就是风险。客户的耐心会变,对手会动,现金流会紧,市场窗口不会一直等你。很多项目死在迟迟进不了现实:会开了十几轮,方案改了十几版,客户始终没看到东西。一个粗糙但能跑的版本,往往比一个完美但出不来的版本更有用。先跑起来,才知道客户要不要,钱收不收得回来,哪里是真问题。

坑也是这样埋下的。没有人第一天就想埋一个三年后会炸的坑。大家只是说:这个版本先这样,这个权限以后再补,这个监控下个版本再上。每一次都不严重,每一次都有现实理由。几年后系统出事,回头看,问题是被一次次合理的短期选择养大的。

所以「要快还是要稳」问错了。该问的是:哪些地方可以先糙,哪些地方必须现在做对。

可以先糙必须现在做对
页面不够好看钱:金额、退款、对账
有几步流程要手动数据:不丢、不乱、不被误删
功能少几个权限:谁能看、谁能改
文案不够顺客户信用:答应的事做到
后台操作不够方便核心交付:主流程走得通

放到餐厅后台上:首页图表丑一点,可以;订单金额算错一分钱,不行。设置页少一个开关,可以;订单从「待接单」直接跳到「已完成」,不行。

这张表也是你和老板、客户谈的工具。他催你快,你不用跟他争长期主义。你告诉他:左边这些先放一放,右边这些今天必须做完,因为出了错要赔钱。这比争论要快还是要稳具体得多。

每次改动都回答三个问题 ​

做完一个改动,AI 会说「已完成」。这句话不算数。算数的是三个问题的答案。

问题合格的回答不合格的回答
改了什么列出改动的文件,每个文件一句话说明为什么改「优化了订单模块」
怎么验证的跑了哪些命令、结果是什么;手动走了哪条流程、看到了什么「已测试,没有问题」
还有什么风险哪些没验证、为什么;可能影响哪些别的功能;哪些已知问题留到以后不写,或者写「无」

第三个问题最容易被省掉,也最有用。没有零风险的改动。写「无」,要么是没想,要么是不敢说。

餐厅后台的规则文件里有两条,专门逼 AI 回答后两个问题:验证跑不通时,要说清哪条命令失败、为什么、哪些没验证;没有真的从前端到后端走通过一次,就不许说「整条链路都通了」。

你可以要求 AI 每次交付都按这个格式写:

text
## 改了什么
- 文件 A:……(为什么改)
- 文件 B:……

## 怎么验证的
- 运行了 ……,结果 ……
- 在浏览器里 ……,看到 ……

## 还有什么风险
- 没验证的:……,原因 ……
- 可能受影响的功能:……
- 留到以后的已知问题:……

把这段格式放进规则文件,它每次都会照着交。你审的时候,先看第三部分。

测试先保最贵的地方 ​

测试是一段自动检查的代码:给一个输入,检查系统的输出是不是你预期的。写一次,以后每次改动都能在几秒钟里重跑一遍。

测试不可能覆盖所有地方。时间有限时,按出错的代价排顺序:

  1. 钱。 金额算错,要么你赔,要么客户多付。
  2. 权限。 不该看的人看到了,不该改的人改了。
  3. 状态。 订单乱跳,没做的菜被标成已完成。
  4. 会丢的数据。 删了不该删的,历史记录对不上。
  5. 其他。 页面、文案、样式。

前四类有一个共同点:出了错,页面上看不出来,等你发现时已经有了损失。第五类相反,出了错一眼能看见,改起来也便宜。所以测试先写在前四类上。

餐厅后台的后端测试就是这样排的。一共七条,每条测一个业务规则:

测试它保住了什么
下两份 14 元的碗,小计 28 元,税 2.45 元,合计 30.45 元;订单里存下菜名和下单时的单价钱:金额由后端按菜单价格算;以后菜单改价,旧订单的金额不变
选了已售罄的菜,下单被拒绝钱和信用:不收做不出来的菜的钱
数量填 0,下单被拒绝数据:不存一张没有意义的订单
「待接单」推进到「已接单」,成功状态:正常流程走得通
「待接单」直接跳到「已完成」,被拒绝状态:不能跳步
没被下过单的菜品,可以删数据:正常的删除可用
被历史订单用过的菜品,不能删数据:旧订单不会指向一道不存在的菜

这里有几个细节。

第一条测试写的是具体数字:单价 14 元,两份,税率 8.75%,合计 30.45 元。这些数字按业务算得出来,你拿计算器就能核对。金额在系统里以「分」为单位存成整数,3045 分就是 30.45 元,这样可以避开小数运算的误差。

被拒绝的那几条,不只检查「报错了」,还检查报的是哪一种错。售罄是一种错误码,跳步是另一种。前端拿到具体的错误码,才能告诉店员哪里不对。

这些测试不连真数据库,用一个放在内存里的假仓库代替。所以几秒钟就跑完,每次改动都可以跑。

餐厅后台现在还没有登录,所以表里没有权限测试。第 10 章(守住底线)加上登录和角色以后,第一批要补的就是权限测试,比如店员不能改税率,没登录的人看不到顾客的手机号。

测试是留给以后的护栏 ​

这七条测试,写的时候保的是这一次。它们更大的用处在以后。

上一章(管住 AI)给餐厅后台加「最低下单金额」,要改下单的业务函数。AI 改这个函数时,可能顺手动了金额的算法,也可能调了检查的顺序,让售罄检查失效。你不会每次都去读它改的每一行。这七条测试每次改动后都会跑一遍,哪条规则被碰坏了,哪条就变红。

所以规则文件里要写「交付前跑测试」,流水线里也要跑测试(见第 7 章 第一天就上线)。测试写一次,以后每个 AI 任务都受它约束,和规则文件一样。

让 AI 写测试,要防三件事 ​

先看一分钟动画,再读下面的细节:

测试可以交给 AI 写、交给 AI 跑。但你要防三件事。

一,测试照着代码抄。 AI 先写了代码,再写测试,测试很容易把代码里的算法再算一遍。代码算错了,测试跟着错,结果还是绿的。防法是预期值由你来给,用业务的话给:「两份 14 元,税率 8.75%,合计应该是 30.45 元。」

二,为了变绿去改测试。 测试红了,AI 有时会去改测试:放宽检查,或者干脆删掉。餐厅后台的规则文件里写了一条:不许为了让检查通过去削弱测试。审 PR 时,看到测试文件里的预期值被改了,要问清为什么。

三,测试其实什么也没测。 测试全绿,不代表它抓得住错误。验证办法很简单:故意改坏一次。让 AI 把税率算错,或者把「待接单不能直接到已完成」这条规则删掉,再跑测试。对应的测试应该变红。没变红,说明这条测试没起作用。看完让 AI 把代码改回来。

给 AI 写测试的提示词,可以这样写:

text
给订单服务补后端测试。只测业务规则,不测页面。

要覆盖这些情况。预期值以我给的为准,不要从代码里推算:
1. 下 2 份单价 14 元的菜,税率 8.75%:小计 28.00,税 2.45,合计 30.45。订单里保存菜名和下单时的单价。
2. 选了已售罄的菜:拒绝,返回「菜品不可售」的错误码。
3. 数量为 0:拒绝,返回「请求不合法」的错误码。
4. 待接单 → 已接单:成功。
5. 待接单 → 已完成:拒绝,返回「状态流转不合法」的错误码。
6. 没被下过单的菜品:可以删除。
7. 被历史订单用过的菜品:拒绝删除。

测试不连真数据库,用内存里的假数据。
写完运行测试,贴出结果。然后把第 5 条对应的状态规则临时删掉,再跑一次,确认第 5 条测试变红,贴出结果。最后恢复代码,再跑一次全部测试。

测试过了,还要演示一遍 ​

测试只证明每条规则单独成立。它证明不了页面真的调到了后端,后端真的连上了数据库,几个环节接在一起能走通。

所以凡是动了主流程的改动,你都要亲手演示一遍。餐厅后台的演示路线是:

  1. 打开首页,记下今天的订单数和收入。
  2. 去订单页新建一单:选一位顾客,加两份同一道菜,提交。看金额对不对。
  3. 再建一单,这次选一道已售罄的菜。应该提交不了,提示清楚。
  4. 把第一单从「待接单」一步步推到「已完成」。每一步只出现合法的下一步按钮。
  5. 回到首页,订单数和收入应该变了。去客户页,这位顾客的消费金额和订单数也应该变了。

五步走完,大约五分钟。哪一步不对,按第 13 章(出事了先找证据)的方法,把页面、操作、实际结果、预期结果和报错原文交给 AI。

演示时最好请一个没参与开发的人来点。你太熟悉自己做的东西,会不自觉地绕开不清楚的地方。

本章做完的样子 ​

  • 每次改动的交付说明都回答了三个问题:改了什么,怎么验证的,还有什么风险。
  • 餐厅后台的后端测试覆盖了下单金额、售罄、非法数量、合法和非法的状态流转、菜品删除。
  • 你故意改坏过一次规则,亲眼看到对应的测试变红。
  • 你按五步路线演示过一遍真实流程,首页和客户页的数字跟着变了。
  • 你能说出餐厅后台哪些地方现在可以先糙,哪些地方必须现在做对。

这一步谁来做 ​

交给 AI 的你要判断和验收的
让 AI 写测试、跑测试。测试有没有覆盖会出钱、出权限问题的地方;演示一遍真实流程。

上一章:第 5 章 管住 AI:规则、工作流和审查 · 下一章:第 7 章 第一天就上线

从 Demo 到商用:用 AI 编程,把 Demo 做成能收钱、能长期运行的项目。