给字段遗漏错误建立可复现的失败样本卡

模型少返回了一个字段，先别急着给提示词补上“不要遗漏”。字段可能在输入里就不存在，可能被截断，可能因输出格式错误被解析器丢掉，也可能是模型确实没抽出来。没有保存现场，这几种情况很容易被归成同一个问题。

失败样本卡的价值，是把“这次不对”变成别人能重新检查的证据。卡片不需要很长，但输入、预期、实际输出和运行条件必须能对应起来。

先确认遗漏的对象

假设任务从报修消息提取 device、location、symptom。构造输入是“二楼会议室的投影仪无法开机”，期望设备为投影仪、位置为二楼会议室、现象为无法开机。如果原始响应只给设备与现象，位置字段没有出现，才能按这个任务契约记录字段遗漏。

若模型输出 location: null，则是“字段存在但值缺失”，与字段键不存在不同。若返回了位置，但下游展示没显示，应先调查解析和映射。分清错误层次，可以避免用改提示词掩盖接口问题。

这张卡首先是证据容器。根因可以后补，不能拿未经验证的猜测覆盖原始记录。

卡片只保存必要而完整的上下文

一张最小卡片可以包含样本标识、任务契约版本、原始输入、完整提示版本、期望字段、原始响应、解析结果和校验错误。模型的确切标识与调用参数也应记录，若有检索或工具调用，保存当时实际进入模型的材料。

“完整”指复现所需的信息完整，不是把整套业务日志搬进去。涉及个人信息或机密内容时，优先使用经过授权的脱敏样本；脱敏必须保留导致错误的语言结构。把“二楼会议室”随手删成空白，会让位置遗漏的复现失去意义。

对于外部模型服务，确切模型标识与参数有助于复核，但不能保证未来逐字重现。服务端行为和不可控随机性都可能影响输出。因此，卡片要同时保存当时原始响应，不把“重新调用没出现”当成从未发生。

预期答案需要有依据

卡片里不要只写“应该有 location”。要标明这个要求来自字段定义，并引用输入中的“二楼会议室”。如果字段规范写的是楼层，期望却要求完整会议室名称，问题可能在标注而不在模型。

对有歧义的样本，保存允许答案集合或转入待裁决状态。比如“隔壁那台投影仪坏了”没有明确位置，除非对话上下文能解析“隔壁”，否则不能把某个会议室当作唯一标准。失败库不能靠猜测扩容。

用最小复现查出触发条件

先按原条件复查，再逐项移除无关内容。保留问题的最短输入，能帮助判断遗漏是否与长文本、并列字段或嵌套结构有关。但原样本仍要保留，最小样本作为派生记录关联过去，避免丢失真实现场。

例如原消息中包含设备、位置和现象，还夹有多句背景。删掉背景后位置恢复了，只能说明背景与当前失败有关，不能立即断言“模型注意力不足”。继续检查位置是否因句法变动更明确、输入是否被截断、输出长度是否受限，才有更扎实的解释。

如果同一条件下有时遗漏、有时完整，记录复现次数与每次结果。不要仅保存失败那一次来估计发生率，也不要因为某次成功就关闭问题。样本卡负责展示现象，发生率需要另有明确采样方法。

让修复回到同一组检查

每个候选修复至少跑原样本、最小样本和邻近正常样本。给位置字段加一句强调，可能解决当前问题，却让模型在位置缺失时编造地点；因此要带上无位置输入，检查修复是否引入新错误。

最后在卡片中追加修复版本、验证结果和仍未解决的边界。状态可以是待复现、已复现、待裁决、已修复或无法稳定复现，但状态变化要有证据。一个清楚记录的未解决问题，比写着“优化完成”却找不到运行条件更有用。

字段遗漏不神秘。把契约、输入、模型输出和解析过程逐层放到桌面上，很多看似需要“炼丹”的问题，会先变成可以逐项排查的工程事实。