让 AI 帮你写故障报告:先保住复现条件,再删掉无关细节
遇到故障时,人很容易把操作经过、猜测原因和修复愿望混成一段话。AI 可以帮忙整理,但先让它寻找原因,往往会得到一份很像答案的猜测。更稳妥的第一步是交付可复现的问题:别人照着做,能看到同一种错误,才有条件继续定位。
AI生成概念配图
先把现象写成一组对照
Stack Overflow 的官方帮助把最小复现概括为材料尽量少、必要部分齐全,并且实际测试过能够复现。本文把这一原则用于 AI 辅助故障报告。最小不是句子最短,而是在保住问题的前提下,去掉不会影响它的内容。
以下是虚构例子:“纸页清单”测试版里有两条任务,甲已完成,乙未完成。选择“仅显示已完成”后,页面只剩甲;点击导出,文件却含甲和乙。预期是导出当前筛选结果,实际是导出全部。预期依据还应注明来自产品约定,否则也可能只是用户和产品对导出范围理解不同。
让 AI 提议删减,由人逐项运行
原始报告可能附带几十条任务、截图和一整段聊天。让 AI 先列出“必须保留”和“可尝试移除”的内容:筛选状态、两条任务的完成状态、导出入口应保留;任务颜色和无关附件可以尝试移除。不要一次清掉所有因素,否则问题消失后不知道是哪一步改变了条件。
先把二十条数据缩成两条,重新执行相同步骤;仍能复现,再去掉标签和附件。若只留已完成任务就看不出异常,应恢复那条未完成任务,并记录它为何必要。这里保留的是能区分预期与实际的最小对照,不能把数据删到“导出成功”就宣称例子已经简化。
为每轮保留删了什么、怎样运行、看到了什么三项记录。若删减后变成“文件根本打不开”,那是另一个现象,不能算原故障仍然存在。让 AI 比较两次输出是否属于同一问题;结论仍由实际运行结果决定,并保存最后一份确实能复现的材料。
复用模板:只整理证据,不代填结果
可复用模板:请把以下材料整理成故障报告,字段为环境、前提、最短操作步骤、预期及依据、实际结果、复现次数、附件和未确认项。将我的猜测单独放置。先提出可删减内容及每次删减后的验证动作,不要声称运行过。缺少版本、权限或输入样本时写待补充;不要编造错误日志。
例子的成稿可以写:“在测试版中创建甲、乙两条任务,将甲标记完成;切换到已完成筛选,确认列表只显示甲;从列表右上角导出。预期一条,实际两条。本机三次复现三次,其他浏览器未验证。”版本和浏览器名称由实际测试者填写,不能照抄示例补齐。
最后交给另一位人从头操作
请没参与排查的人用报告从空白状态复现,观察是否还要追问“点哪个按钮”“账号需要什么权限”。若问题只在旧账号出现,空白数据无法复现,就保留账号历史这一未知条件,不要为了做出漂亮示例而隐去它。偶发故障还要写清观察窗口和成功、失败次数。
公开报告前移除令牌、个人信息和业务数据,替换样本后再测一遍,确认脱敏没有改变问题。AI 擅长压缩与组织材料,却不能凭叙述证明根因。交付报告、最小样本和运行记录,留下可继续检验的假设,比附上一段自信的修复解释更有用。


