文件边界与验收标准是怎么和 ai 讨论出来的

来自夹夹 QQ 群讨论,审核后公开 · 。查看原始讨论

提问

文件边界与验收标准是怎么和 ai 讨论出来的

回答

讨论的方式是先把这件事弄清楚:你交给 AI 的是一份“候选方案”,并非让 AI 帮你决定规格。规格的最终决定权在你手上,AI 的作用是帮你把规格写清楚、找出漏洞。

具体的做法:

先自己写一版。你自己先写一版粗糙的规格,哪怕只有半页纸,写清要做什么、给谁用、什么情况算完成。不要直接空手去问“帮我设计个规格”,那样它给你的东西你也没法判断对错。

然后让 AI 帮你找遗漏。让它以反方视角来检查,例如“这是我写的规格,指出哪些地方没有明确写出来,实现时会产生歧义,哪些验收条件没法客观判断”。这一步最容易有收获,常见的是边界条件(空值、并发、失败重试)、状态转换没有写全、以及“做得快”“效果好”这种无法验证的标准。

文件边界不需要和 AI 一起讨论,只需让它给你候选划分。给它看一眼目录结构和模块职责,问“按这个规格,如果需要三个人并行修改,你会怎么切文件边界,哪些文件会被多个人同时改”。它给出的划分只是参考,由你判断哪条边界合理。判断标准就是前面说过的:一个子任务只改两三个文件,并且能自己跑命令验证。

验收标准最好先由你写,再让 AI 帮你改。因为验收标准是唯一能校准方向的工具,一旦让 AI 起草,它就会在无意中放宽自己能通过的门槛。你写完之后再让它挑问题,例如“这条测试能不能被作弊通过”“这个断言是不是太宽松”。它在这类挑刺上通常挺靠谱。

最后把达成一致的内容固定成文档。规格、文件清单、验收命令写进仓库里的一个文件,之后 agent 就照着这份文档执行,不再临场商量。讨论阶段的产物最后必须整理成文档,否则到了并发执行阶段,每个人或每个 agent 对规格的理解都不一样。

一句话概括:AI 帮你把规格写得更明确、更可验证,但规格界定什么算“对”,这件事不能交给它。

所属话题:Agent 工程