不要只说“修一下这个 Bug”
一个可执行的 Codex 任务应回答四个问题:要达成什么结果、允许改哪里、有哪些约束、如何证明完成。
“登录坏了,帮我修一下。”
缺少复现条件、范围和验收方式。“复现用户首次登录偶发 504 的问题。仅修改 auth 模块,保留现有 API;解释根因,添加回归测试并运行测试。”
目标、范围、约束和验证都很明确。先读再改
让 Codex 先检查相关代码、配置和测试,确认理解后再实施。
缩小范围
指出允许修改的模块,避免无关重构扩大风险。
要求验证
明确测试、构建、lint 或手工检查的验收标准。