很多人开始用 Codex 后,最先遇到的不是"不会写代码",而是 项目文件读取。这类问题如果没有边界,很容易变成:一会儿改提示词,一会儿换模型,一会儿重装工具,最后连最初的问题是什么都说不清。
这篇文章只处理一个主题:围绕"工作目录与授权",怎样把操作拆成能执行、能检查、能继续推进的步骤。你不需要先掌握完整框架,也不需要一次做完复杂项目。
先给结论:先确认工具看见了什么,再要求它修改什么。 只要每一步都有可见结果,下一步就不会靠猜。
若你准备通过 API 使用 Codex,可以通过这里快速开始 AICode(callyouai)
一、先把目标缩小到一个可判断的问题
本篇的场景是"项目文件读取"。这一轮只关注 工作目录与授权,范围是:启动目录、工作区权限、忽略规则和最小读取测试。
这里有一个很重要的原则:不要把"最终想做什么"和"这一轮要验证什么"混在一起。最终目标可以是一个完整网站、一个工具或一个自动化流程;但当前目标应该小到几分钟内就能确认结果。
例如,不要说"帮我把项目全部处理好",而是说"先确认当前目录能不能读取""先让这个按钮执行一次正确跳转"或"先让表单在空输入时显示提示"。
目标缩小之后,AI 给出的答案会更容易检查,你也更容易知道该不该进入下一步。
二、先让 Codex 给出方案,不要直接接收一大段代码
在任何修改前,先把任务写成下面这种格式:
bash
我正在处理:项目文件读取。
本轮只解决:工作目录与授权。
范围包括:启动目录、工作区权限、忽略规则和最小读取测试。
请先输出:
1. 你理解的用户操作流程;
2. 可能涉及的状态、文件或配置;
3. 最小实现步骤;
4. 我可以手动检查的验收条件。
先不要生成完整代码,也不要增加未要求的功能。
这一步不是多余的。它能让你先发现两类问题:一类是 AI 把任务理解宽了;另一类是你的需求本身没有说清楚。两类问题都应该在生成代码前解决。
看方案时,重点看三点:是否只围绕当前目标;是否列出了不确定项;是否给出了可以亲手检查的结果。如果方案中突然出现登录、数据库、重构全项目之类的内容,先要求它删掉。
三、实现时,一轮只做一个动作
操作方式建议固定为三轮。
第一轮:只跑主流程
第一轮只要求功能出现,不追求完美。比如页面能打开、按钮能响应、请求能返回、列表能显示。不要在这一轮加入样式细节、兼容性优化或额外功能。
第二轮:补验收条件
主流程能跑后,再让 Codex 根据验收条件补齐缺失部分。注意是"补齐当前条件",不是"全面优化"。
bash
请根据以下验收条件检查现有实现。
未满足时,只修改相关逻辑,并说明修改了什么。
不要改动未涉及的页面、样式、文件或功能。
第三轮:只修一个真实现象
如果发现问题,描述方式要包含复现步骤、实际结果和预期结果:
bash
复现步骤:
1. [操作一]
2. [操作二]
3. [操作三]
实际结果:[看到的现象]
预期结果:[应该发生什么]
请只检查与此现象直接相关的部分,不要重写整个项目。
这样做看起来慢,实际会减少返工。因为每次改动的范围都清楚,出现新问题时也能回到上一轮。
四、验收不靠"看起来没问题"
本篇至少应检查:目录是否正确、单文件是否可读、入口是否识别。
建议把它们写成一张简单清单,每项亲手完成一次。以下是通用写法:
| 检查项 | 操作 | 预期结果 | 不通过时先查什么 |
|---|---|---|---|
| 主流程 | 按正常步骤完成一次操作 | 得到预期页面、响应或结果 | 当前目标是否被正确理解 |
| 异常输入 | 留空、输入错误内容或中断操作 | 有清楚提示,不出现无响应 | 校验、状态和错误分支 |
| 重复操作 | 连续点击或重复执行 | 不产生重复结果或混乱状态 | 按钮状态、事件处理 |
| 修改回归 | 完成改动后重复原有步骤 | 原有功能仍正常 | 改动范围和关联文件 |
AI 说"已完成"不是验收。只有你实际执行后,结果能稳定复现,才说明这一轮可以结束。
五、遇到不符合预期时,按这个顺序处理
第一,不要马上换模型或重做项目。先确定问题属于哪一层:配置、工作目录、输入、代码逻辑还是验收条件。
第二,不要同时修改多个变量。比如不要一次同时改 Key、地址、模型名和代码;也不要同时让 AI 改页面、换依赖和加功能。一次只保留一个变化,然后重复同一个测试。
第三,保存最后一个可用状态。哪怕只是复制当前关键代码或记录修改文件,也能避免下一轮出问题后无处可退。
本篇最需要避免的是:不要为省事授权整个个人目录。这类做法的共同点是范围不断扩大,最后无法判断哪一步导致了问题。
四个位置的检查顺序
先在项目根目录执行 pwd 和 ls,确认启动位置;再让工具只列出顶层目录;接着让它读取一个普通文本文件;最后才让它说明项目入口。若目录列表与终端不一致,优先检查工作区授权或启动目录,而不是让它直接改代码。
六、当前目标通过后,下一步只加一项能力
当你完成本轮目标后,不要立即扩展成一个大项目。下一轮只能选择一件事,例如:补一个错误提示、增加清空动作、优化移动端显示、让结果可复制,或者把一个手工步骤变成自动操作。
每次增加一项能力,都重新写清楚输入、结果和验收条件。这样积累下去,你得到的不只是一个能跑的页面,而是一套可以反复使用的 AI 编程工作方式。
最后检查一次
在发出下一条指令前,问自己三个问题:
- 这次是否只验证一个结论?
- 是否能在几分钟内看到成功或失败?
- 失败后是否知道回到哪一步?
三个答案都明确,再继续下一轮。先把一个小步骤走稳,比让 AI 一次生成更多内容更有价值。