Codex 测试失败只剩一串编号?给验收断言起一个业务名
[!NOTE]
没有业务含义的断言名称会让失败报告变成猜谜,修复者不知道它保护的是输入校验、兼容性还是副作用。 本文用一个离线、可运行的小例子把判断写清楚,帮助读者在真实项目中先获得证据,再让工具推进下一步。
一、先把问题缩到可说明的范围
没有业务含义的断言名称会让失败报告变成猜谜,修复者不知道它保护的是输入校验、兼容性还是副作用。 这不是要求工具“更聪明”,而是要让输入、预期和完成条件都可被检查。本文中的业务对象、数据和命令均为虚构演示,不能把演示输出说成线上实测。
OpenAI 官方文档说明多步骤任务可维护上下文与工具状态;本文的断言命名规则为原创实践。 当前核验日期为 2026-10-13;接入真实客户端前,请重新阅读对应官方文档与本地项目规则。
二、建立一份可以交接的操作清单
用动作和结果命名断言;为失败消息附上期望与实际;把每个断言关联到一条需求或风险。 清单应同时保存事实、假设和待确认项;不要把“文件已经生成”“页面已经打开”直接升级成外部动作已经成功。
每一步都应有稳定名称、输入范围、预期结果和证据位置。这样换人、换会话或中途恢复时,仍能先读证据再继续,而不是凭聊天记录猜测。
三、运行离线最小示例
以下代码只使用 Python 标准库或语言内置能力,不访问网络、不读写真实项目,也不操作外部账户。保存为独立.py