文档目录05 / 20

看懂实现05 / 20

核对依据

本页内容

只听 Agent 说“已经实现”是不够的。每段实现说明后面都跟着它的依据:读过的代码、跑过的测试、运行记录和界面截图,点开就能核对。有人问起时,你能指到具体的地方。

依据里有什么

在旁注里展开“依据”。常见的材料有这几类:

材料显示为点击后
代码位置函数名,或“文件名:行号”芯片代码面板在右侧打开,定位到那几行
命令输出,例如一次测试运行芯片在右侧辅助栏打开完整输出
代码差异(diff)芯片在右侧辅助栏打开
截图和其他图片缩略图放大查看
《续费》宽限期一段的依据:读过的代码、一次测试运行(6 个通过)和实现时留下的截图。点击代码位置,代码面板在右侧定位到 grace.ts 的那几行。

命令输出、diff 和截图来自 Agent 实现时留下的记录:它在哪一轮跑了什么命令、截了什么图,Noea 都保存下来,说明可以直接引用。

查看代码位置

代码位置出现在句子中间时,通常显示为函数或变量的名字,例如 openGrace;其余情况显示为“文件名:行号”的芯片,例如 grace.ts:6-18。同一条说明里有两个同名文件时,芯片会带上上一级目录。

鼠标停在名字或芯片上,会显示完整路径、行号范围和符号名。点击后,代码面板以这个文件为范围在右侧打开,定位到所指的行。如果这个文件仍停在某一轮实现结束时的状态,那一轮的改动会叠在整个文件上,方便你看清是哪一轮写下的。右键菜单可以用默认程序打开、在访达中显示或复制路径。

代码后来挪了位置,芯片显示的行号和点击定位都以现在的位置为准。如果说明引用的那段代码已经改过,只找得到名字,芯片会变淡;文件已删除或所指代码找不到了,芯片会变淡并带删除线,悬停时说明原因。出现这两种情况时,这段说明多半需要再次调查。

依据能证明到哪一步

看到一项材料时,先分清它属于哪一种:

材料能帮你确认什么还要留意什么
实现代码或测试代码代码采用了什么逻辑,测试定义了哪些场景有测试代码,不等于测试跑过、通过过
以前的运行结果当时跑了什么,当时的结果如何之后代码变了,结果可能已不适用
这次解释实际执行的验证在这次的环境和范围内,结果如何通过的场景不能代表没覆盖的场景

解释和调查主要靠阅读代码与已有材料,不会每次都重新跑测试、构建或启动应用。只有读代码无法确认某个影响结论的关键事实时,Agent 才会按需要验证。好的依据会写明它没有验证什么,例如“没有对接真实支付渠道,扣款结果由测试替身给出”。证据不足、没找到实现或者意图有歧义时,依据和关注应该如实写出来,而不是给出一个看似确定的结论。

也要记得:说明是一份带证据的调查记录,不是验证证书。让一个 Agent 再去检查另一个 Agent 的实现,并不会自动得到更高的确定性。依据的价值在于你能点开核对,而不在于说明写了“已确认”。

看截图和界面

有些行为只看代码说不清,比如一条提示是否真的出现在界面上。Agent 在实现时如果截了图,说明可以把截图列为依据,例如“宽限期内,团队设置页顶部显示一条提示”。

点击缩略图放大查看。看截图时留意它拍的是哪个页面、什么状态,以及它是哪一次运行留下的:截图证明的是当时的界面,之后代码变了,界面也可能变。

逐项核对

核对依据时,可以逐项问:

  • 这个引用对应的是不是这段意图在说的事?
  • 测试覆盖的是哪种情况,边界情况有没有?
  • 结果是否真的支持说明里的结论?
  • 依据有没有写明哪些情况没有验证?

例如宽限期的依据写着“跑了宽限期的测试,6 个全部通过”,但关注里提到“没有测试覆盖第 3 次重试成功的情况”。这时你知道,第 3 次重试那条路径只有代码阅读,没有运行证明。

依据不够时

缺少关键场景时,把鼠标移到段落上,在左侧点“就此提问”,明确要求 Agent 验证:

请补一个测试:宽限期第 6 天第 3 次重试成功,订阅应回到正常状态、不降级。跑完告诉我结果。

Agent 完成后,Noea 会自动解释这一轮;如果你关闭了自动解释,在段落左侧点“调查”。新的说明会把这次运行列为依据。

说明里的结论和依据对不上,或者你认为 Agent 理解错了意图,也在这里追问,不要为了迁就代码去改意图。见把聊定的事写进意图。