Codex 写偏了？把这份开工单放在第一句话

“你看着改吧”对小演示很方便，对已有项目很危险：Agent 可能选了另一套样式、碰了不相关的文件，还把没运行的测试写成“建议已完成”。开工单不需要长，关键是让输入和完成标准一一对应。

OpenAI 将 Codex CLI 定位为在本地运行的编程 Agent。本篇只提供通用协作方法，不改你的认证、模型配置或主目录；已经能工作的客户端，先把当前任务交代清楚就能开始。

先给事实，再给目标

告诉它这是哪个项目、相关文件在哪、已经出现什么行为。报错要带触发步骤，界面问题要带实际尺寸和目标位置。不要只说“跟上次一样”，新会话未必知道上次的决定。

一份可以直接复制的开工单

项目：[项目名与目录]
目标：[一个具体用户操作及其预期结果]
现状：[现在实际发生的行为，附错误或截图说明]
范围：[允许修改的模块；必须保留的功能]
参考：[相关文件、接口文档、既有样式]
验收：
1. [正常情况的操作和结果]
2. [失败或空数据情况的结果]
3. [需要检查的设备或页面]
请先读项目现有说明和相关实现，再做最小完整修改。
结束时告诉我改了哪里、实际验证了什么、还有什么没验证。

例子：把“加个搜索”改成可验收的任务

目标：在订单页按订单号搜索。范围：只改订单查询和搜索框，不改支付。验收：回车和点击搜索结果一致；清空后恢复第一页；没有结果显示空态；请求失败保留输入；翻页不丢搜索条件。

这些条件会帮助 Agent 同时检查前端状态和后端查询，而不是只在页面上放一个输入框。最终交付应包含真实执行记录；若缺少服务环境，应明确哪一步未验证。

长任务如何避免反复失忆

每完成一个阶段，留下简短交接：已经确定的约束、改动文件、实际验证、未完成事项。让下一次会话先读交接和现有代码，别把全部旧对话无差别粘进去。过期结论也要删，否则旧约束会持续影响实现。

遇到 Agent 说完成，但界面没变

先确认你正在运行的程序来自哪个构建、改的是哪个项目副本、页面是否读了旧缓存。再检查代码差异和执行日志。不要立刻让它重写整个功能，否则很可能把“运行的还是旧版本”变成一轮无关改动。

交付前只问四件事

• 每条验收条件对应哪个结果？

• 测试是实际运行了，还是只写了命令？

• 有哪些依赖需要我配置？

• 当前仍未完成的是什么？

一个诚实写出“本机检查通过，生产尚未部署”的交付，比一句笼统的“全部完成”更有用。

来源与更新

EasyAI 编辑部原创整理 · 2026-10-31 核对。案例、提示词和验收清单为原创；工具能力以项目官方说明为准，未宣称所有环境均已实测。

OpenAI · Codex