看懂实现05 / 20
核对依据
本页内容
只听 Agent 说“已经实现”是不够的。每段实现说明后面都跟着它的依据:读过的代码、跑过的测试、运行记录和界面截图,点开就能核对。有人问起时,你能指到具体的地方。
依据里有什么
在旁注里展开“依据”。常见的材料有这几类:
| 材料 | 显示为 | 点击后 |
|---|---|---|
| 代码位置 | 函数名,或“文件名:行号”芯片 | 代码面板在右侧打开,定位到那几行 |
| 命令输出,例如一次测试运行 | 芯片 | 在右侧辅助栏打开完整输出 |
| 代码差异(diff) | 芯片 | 在右侧辅助栏打开 |
| 截图和其他图片 | 缩略图 | 放大查看 |
命令输出、diff 和截图来自 Agent 实现时留下的记录:它在哪一轮跑了什么命令、截了什么图,Noea 都保存下来,说明可以直接引用。
查看代码位置
代码位置出现在句子中间时,通常显示为函数或变量的名字,例如 openGrace;其余情况显示为“文件名:行号”的芯片,例如 grace.ts:6-18。同一条说明里有两个同名文件时,芯片会带上上一级目录。
鼠标停在名字或芯片上,会显示完整路径、行号范围和符号名。点击后,代码面板以这个文件为范围在右侧打开,定位到所指的行。如果这个文件仍停在某一轮实现结束时的状态,那一轮的改动会叠在整个文件上,方便你看清是哪一轮写下的。右键菜单可以用默认程序打开、在访达中显示或复制路径。
代码后来挪了位置,芯片显示的行号和点击定位都以现在的位置为准。如果说明引用的那段代码已经改过,只找得到名字,芯片会变淡;文件已删除或所指代码找不到了,芯片会变淡并带删除线,悬停时说明原因。出现这两种情况时,这段说明多半需要再次调查。
依据能证明到哪一步
看到一项材料时,先分清它属于哪一种:
| 材料 | 能帮你确认什么 | 还要留意什么 |
|---|---|---|
| 实现代码或测试代码 | 代码采用了什么逻辑,测试定义了哪些场景 | 有测试代码,不等于测试跑过、通过过 |
| 以前的运行结果 | 当时跑了什么,当时的结果如何 | 之后代码变了,结果可能已不适用 |
| 这次解释实际执行的验证 | 在这次的环境和范围内,结果如何 | 通过的场景不能代表没覆盖的场景 |
解释和调查主要靠阅读代码与已有材料,不会每次都重新跑测试、构建或启动应用。只有读代码无法确认某个影响结论的关键事实时,Agent 才会按需要验证。好的依据会写明它没有验证什么,例如“没有对接真实支付渠道,扣款结果由测试替身给出”。证据不足、没找到实现或者意图有歧义时,依据和关注应该如实写出来,而不是给出一个看似确定的结论。
也要记得:说明是一份带证据的调查记录,不是验证证书。让一个 Agent 再去检查另一个 Agent 的实现,并不会自动得到更高的确定性。依据的价值在于你能点开核对,而不在于说明写了“已确认”。
看截图和界面
有些行为只看代码说不清,比如一条提示是否真的出现在界面上。Agent 在实现时如果截了图,说明可以把截图列为依据,例如“宽限期内,团队设置页顶部显示一条提示”。
点击缩略图放大查看。看截图时留意它拍的是哪个页面、什么状态,以及它是哪一次运行留下的:截图证明的是当时的界面,之后代码变了,界面也可能变。
逐项核对
核对依据时,可以逐项问:
- 这个引用对应的是不是这段意图在说的事?
- 测试覆盖的是哪种情况,边界情况有没有?
- 结果是否真的支持说明里的结论?
- 依据有没有写明哪些情况没有验证?
例如宽限期的依据写着“跑了宽限期的测试,6 个全部通过”,但关注里提到“没有测试覆盖第 3 次重试成功的情况”。这时你知道,第 3 次重试那条路径只有代码阅读,没有运行证明。
依据不够时
缺少关键场景时,把鼠标移到段落上,在左侧点“就此提问”,明确要求 Agent 验证:
请补一个测试:宽限期第 6 天第 3 次重试成功,订阅应回到正常状态、不降级。跑完告诉我结果。
Agent 完成后,Noea 会自动解释这一轮;如果你关闭了自动解释,在段落左侧点“调查”。新的说明会把这次运行列为依据。
说明里的结论和依据对不上,或者你认为 Agent 理解错了意图,也在这里追问,不要为了迁就代码去改意图。见把聊定的事写进意图。