返回文章列表

怎样核对 AI 写下的事实?给技术文章留出证据

从一段安装说明开始,演示主张拆分、来源留痕、版本核对和一次可复现的验收。

文章目录

文章里一句“新版本让任务更快”,读起来顺畅,落实起来却需要回答好几个问题。新版本是哪一个,测试跑了什么任务,设备和部署条件变了没有,结果的变化有多大。让模型帮忙起草时,这些细节很容易被压进一个流畅的句子里。把句子的含义逐一拆开,再回到手里的原材料核对,能把写作和复核分成两个清楚的动作。

先把一句话拆成可以核对的主张

用一段虚构的技术文章做练习。“笔记应用从第二版起支持离线导出,在旧设备上也能更快生成文件。”这句话包含版本、功能、设备范围和性能四种说法。要证明其中一项,所需材料可能和另一项完全不同。一次成功导出能说明测试环境里发生了什么,性能比较却要得到两组可比较的数据。

最简单的拆法是每行只写一个主张。第一行写“离线导出在第二版引入”,第二行写“断网时可以生成指定格式文件”,第三行写“旧设备可以运行第二版”,第四行写“第二版在旧设备上的导出耗时小于第一版”。拆开之后,缺少依据的主张会很醒目,也更容易决定删掉、缩小范围或者补证据。

主张表上还可以标明它的类型。数字、版本、默认设置能够直接对照材料。因果关系需要看测试设计。使用建议通常是结合场景作出的判断。文章可以同时包含观察、解释和建议,只要读者能读懂它们分别依据什么。例如“这一批文件导出较慢”是记录所得,“可能与附件数量有关”是待测试的解释。

建一份可以回到原文的来源记录

每份材料给一个短编号,例如资料甲是产品说明的第二版摘录,资料乙是自己记录的执行结果,资料丙是旧设备列表。记录材料的标题、版本、日期和定位方式。定位可以是小节、段落、操作时间或者文件页码。日后只用几秒就能回到原位置,比在文件末尾列一组模糊的标题有用。

保存摘录时尽量连上下文一起保留。说明书上面写“导出适用本地笔记”,下一段写“引用网络附件的笔记需要联网”。只保存第一段,模型可能把功能扩展到所有笔记。判断时还要看限定对象、例外条件和否定句。若某句含义必须靠前一个段落中的术语定义才成立,来源记录也要包含那一定义。

写测试记录时,标明实际观察的环境和操作。记录软件版本、设备类型、输入大小、起止条件和结果。测试过程如果先联网同步了附件,后续断网导出只能说明缓存已经准备好的情况下可行。下次换设备或者换数据大小,可以据此判断两个结果有没有比较基础。

只有截图时,可以按截图上可读的内容标出版本和步骤,仍然缺失的字段留空。遇到一份反复更新的内部说明,可以同时记保存日期和摘录文字。后续说明更正了某个参数时,旧文章还能找到当时使用的材料,并决定要不要修订。来源记录的任务是让说法可追踪,记录方式可以很朴素。

把模型安排在适合它的位置

先给模型编号后的材料和待核对文稿,请它提取高风险主张。它可以扫出版本号、数量、因果词以及“始终”“全部”等范围词。接着要求按主张逐条列出支持它的原文,并标记资料中的限定条件。这个过程可以加快寻找位置,最后判断仍需要和材料对照。

下面的任务说明可以直接用在几份编号资料上。把事实主张单独列出,能减少模型为了让答案完整而沿用原句结论的压力。

请审阅文稿,把含有数字、版本、功能范围或因果关系的句子拆成单条主张。
每条返回原句、最小主张、支持材料编号、短摘录和判断。
判断只使用:支持、部分支持、冲突、材料不足。
如果材料只覆盖某类设备或某种输入,请写出限定条件。
材料只有间接描述时,保留材料不足,并写出需要怎样的证据。
最后给出可以直接替换的句子,保留原材料能支持的范围。

收到结果后,先检查材料编号对应位置是否存在,再看引文是不是真正出现在那里。模型可能由于相似措辞把两段拼起来,生成一句原文里从未出现过的话。把它给出的短摘录做一次全文搜索,通常就能发现这类问题。涉及数值时,还要检查单位和小数位。比如每个任务耗时与每批任务耗时有不同的分母。

有时一条主张被标成“支持”,实际依据只说明产品提供了某个配置项。配置项存在,并不足以得出运行时已开启。审阅前先约定测试中的状态与说明书中的能力如何分开写。把“说明书列出这个开关”和“本次运行开启了这个开关”分别保留在主张表中,就不会把两句合并成未经证实的运行结论。

只引用证据确实能支持的范围

假设资料甲写明“从第二版开始可以将本地纯文本笔记导出为文本文件”。资料乙记录“第二版在断网后导出三份已经保存的纯文本笔记,结果都能读取”。这时可以写“第二版提供纯文本笔记导出,本次断网测试的三份已保存笔记都完成了导出”。读者能知道产品说明说了什么,也知道验证过哪些输入。

如果资料丙只说明设备能安装第二版,文章可以据此写“这类设备列在支持安装的范围里”。要写“导出更快”,还需要同一类设备、相同输入和两版软件的可比较结果。把同一批笔记依次交给两版,重复多次,记录每次耗时。测试时保持后台负载和缓存条件尽量一致,分析时同时查看中间水平和异常值。样本长度与测试状态都应写进说明。

遇到比较词时,明确比较对象很重要。若第二版比第一版快,只在短笔记上观察到,就把范围说清。“对本次三份短笔记,第二版的三轮测量耗时都低于第一版”,比“新版大幅优化性能”信息更具体。如果实际记录里只有一轮,也可以写它是一次测量,为读者保留判断变化是否稳定的空间。

遇到“新增”“首次”和“现在默认”这类时间词,还要检查版本序列。一页当前说明能说明当前行为,是否在这一版首次出现通常需要历史材料。手头缺少旧版资料时,可以把“首次支持”写成“在本次测试的版本上支持”。保留下来的说法与实际核对到的范围相符,以后找到旧资料也容易追加。

让推导过程能被另一个人重做

对数字类结论,最好先把公式和输入摆出来。比如一组记录中旧版导出时间为十秒,新版为八秒,按旧版耗时作基准,耗时减少比例是两秒除以十秒,等于百分之二十。把“减少百分之二十”写成“速度提高百分之二十”会变换指标,因为速度若定义成同样工作量除以耗时,比例是十除以八。直接用耗时减少来描述更容易回查。

多条观测汇总时写明先计算什么。可以先把每一轮配对,再计算各轮降幅,也可以先比较两个版本的总体耗时中位数。不同口径可能给不同结果。技术文章可以只用一种,只要写清定义和选择理由。需要保留全部细节时,正文给出最重要的结果,附录给出每轮记录和计算过程。

复现操作也应足够明确。请另一人拿同样的素材,在约定设备上打开给定版本,先确认三份样本已保存本地,然后关闭网络,逐份触发导出,记录文件是否生成以及能否打开。发现执行者理解不一致时,修订操作步骤或表格字段。验收需要看可观察的结果,例如导出文件的内容与样本匹配。仅看到“导出完成”提示可能漏掉错误文件或旧文件。

完整流程也适用于公式、小脚本和操作指南。公式可以拿同一批测试数值复算,脚本要记录输入和预期输出,操作指南要沿着步骤走一遍。某个前提影响结果时,把它写在对应步骤附近,例如“首次导出会先创建目标目录”。复现者无需反复在文末寻找关键条件。

当材料相互矛盾时保留判断过程

有时产品说明写“所有设备支持”,一次实测却在某个设备上失败。先核对两个记录是否说的是同一版本、配置和功能。如果文档适用更新版本,失败记录发生在旧版,可以分别写明各自范围。若版本一致,检查设备型号、权限与输入内容。某些冲突需要另一轮观察,记下当前的未知点,避免把任何一份材料直接视为完整解释。

如果文稿引用的是团队的旧结论,后面又找到一份复核记录,应记录更正日期和受影响的位置。一次改动可能牵连摘要、表格和正文举例。请模型逐处寻找同一说法的变体,再人工检查更改是否一致。复核时最好保留两版文字,明确新记录实际改变了哪个事实。

证据缺口是否保留在文章里,取决于它与读者问题的关系。如果旧设备更快只是一个可有可无的顺带说法,删掉便能保持主线。如果文章主题就是性能,缺口需要直接交代。可以写目前有一次测试观察,设备范围还有待增加。读者会因此知道哪些信息能够用于自己的判断。

发布之前做一次逆向核对

从文章里选出读者最可能带走的三条说法。有时这些说法出现在标题、导言或图表摘要,因为它们承担了压缩信息的任务。先从标题往回找正文记录,再从正文找主张表和材料。任何一处扩大范围,都在最靠近读者的文字上修正。例如正文说三份本地样本,摘要也应保留这个边界。

然后把文章交给一个没有参与写作的人,请他只挑一条自己最感兴趣的结论,照文中的信息找回依据或重做操作。观察他在哪一步停住,是找不到原材料编号,还是步骤中缺了环境条件。用这个结果改善文章和来源记录。一次做得扎实的小核对,通常能识别出最需要补的说明。

来源记录不一定要全部随文章发布。简洁的博客可以在相关段落用“测试记录,第二版,三份本地纯文本样本”这样的文字说明,并在作者维护的笔记里保留检查细节。以后材料更新或有人问起测试范围,仍能沿着这条线找回原数据。一篇技术随笔的可靠性,最终落在每个关键说法都有与之相称的依据。

返回文章列表