「帮我修一下搜索,翻页有点问题。」这句话交给 Codex,大概能换来一段看着挺像样的代码。可到底是哪一步出错?按搜索键、换筛选条件,还是点下一页?这三个故障看起来都叫"搜索不对",改的地方可能完全不同。
先给它一条能照着走的操作
以一个虚构的工单列表为例:先翻到第 3 页,再把搜索词改成「电池」,页面依然停在第 3 页,结果显示空白。 预期是换词后回到第 1 页;搜索词不变时,正常翻页仍然有效。
可以把这一段直接交给 Codex,再换成你的页面名和真实操作:
在本地项目里复现:工单列表翻到第 3 页,搜索词改为「电池」,结果仍请求第 3 页。期望换词后从第 1 页查,普通翻页不受影响。先找到搜索词和页码从哪里进入请求,列出相关文件和一条能复现的检查。确认原因后再改;保留现有接口和筛选条件。最后告诉我实际跑了什么,以及哪些情况没验证。
暂时不知道文件名也没关系。告诉它你点了什么、实际出现了什么。如果手上只有一张截图,再加上触发步骤;如果能提供日志,只贴与故障有关、已经去掉敏感信息的几行。拿不准时,可以先加一句:「这一轮只定位,先别改文件。」
改完以后,问清楚它拿什么证明
除了换词回第一页,还要做一次普通翻页。这两步放在一起才有用:要是每次请求都被改成第 1 页,第一步看起来也会通过。仓库有测试就跑相关用例;没有现成环境,就认真记录手动复现步骤和结果。命令没跑起来也直接写原因,不把「建议跑」写成「已通过」。
看差异时先找页码从哪里重置,再确认有没有顺手改接口、缓存或别的页面。原来的筛选条件还在吗?返回按钮恢复列表时,会不会也被重置?挑跟这次故障最相关的两三个边界,通常比再要一份长报告有用。
别每次都解释项目怎么运行
如果每次都要提醒 Codex「用仓库自己的测试命令」「不要编辑生成的目录」,可以把稳定的规则写进仓库的 AGENTS.md。故障截图、这次的关键词和临时取舍则留在当前任务。这样下次修另一个问题时,项目规范还在,工单也不会被上一件事带跑。
下一次遇到"小问题",不妨先写一句「做了什么、看到了什么、应该看到什么」。比如:「换词要回到第 1 页,普通翻页照旧。」光这一句,就已经替改动划出了边界。
说明:文中的工单和故障为演示示例,本文由 AI 辅助撰写。有关仓库说明文件的细节,可参阅 OpenAI 的《Custom instructions with AGENTS.md》。