很多人第一次用Codex，仍然把它当成一个更会回答问题的聊天框。
直接让Codex“把文件整理一下”很危险。文件一移动，网页引用、脚本路径和同事的使用习惯都可能断掉。
所以这篇文章只解决一件事：在不丢文件、不破坏引用的前提下完成项目目录整理。接下来不讲空泛功能，直接看要准备什么、每一步留下什么，以及最后怎样判断合格。
适合谁
适合项目目录里出现多版文档、重复图片、临时导出和不清楚用途的文件，需要建立清晰结构的人。
如果当前只有一个宽泛想法，先把它改成一项可交付任务；如果涉及唯一原件、生产环境或专业结论，必须保留人工确认。
Codex可以读取项目、修改文件和执行命令，因此先使用副本或版本控制，明确禁止触碰的目录与生产环境。高风险操作、唯一原件和最终判断必须留给人工。
开始前准备
- 待整理目录的副本
- 文件用途与保留期限
- 项目内路径引用和入口文件
- 建立一个测试副本或新目录，不直接操作唯一原件。
- 写下一句验收标准：新目录结构可解释，所有移动都有旧新路径映射，构建和引用检查没有新增错误
不要只准备输入，还要准备验收依据。没有对照样本、来源、测试或负责人判断，生成再多内容也无法证明已经完成。
完整步骤
第一步之前：先做一个最小样本
最小样本可以是一份文件、一页内容、一组数据或一个只读任务。它的作用不是展示效果，而是验证材料能读、规则能执行、结果能复查。
第一步：生成只读文件清单
按路径、类型、大小、修改时间和疑似用途盘点，不先删除或移动任何文件。
先停在这里检查一次。此时应已经形成“原始文件清单”，并且能回到原始材料说明它从哪里来。
第二步：查找引用与重复项
确认代码、文档和配置中谁引用了这些文件，用哈希或内容比对识别真正重复项。
这一阶段的完成标志不是工具有回复，而是“引用关系与重复候选表”已经可供人工检查。
第三步：提出新结构和映射
先列旧路径到新路径映射，以及每次移动后需要同步修改的引用。
继续下一步之前，抽查“路径迁移方案”中的边界项和异常项；发现前提不成立就先修正。
第四步：分批移动并验证
每批只处理一种文件，随后运行构建、链接检查或抽样打开，保留回滚记录。
把“迁移日志与验证结果”作为本轮留存证据。后续合并或扩大范围时，都应能用它复盘。
第五步：人工验收并沉淀流程
正式交付前，由真正负责这项工作的人做最后判断。流程如果会重复，再保存输入模板、执行顺序、异常处理和合格样例。
实际示例
一个网站有三套截图目录。先确认页面实际引用，再把仍在使用的图片按产品和场景归档；未引用文件只标成候选，不在没有确认时删除。
可以先这样描述任务：
我正在处理“在不丢文件、不破坏引用的前提下完成项目目录整理”。已有材料包括待整理目录的副本、文件用途与保留期限、项目内路径引用和入口文件。请先不要扩大任务范围，也不要补造缺失信息。先完成“生成只读文件清单”，输出可以人工检查的中间结果；我确认后，再继续“查找引用与重复项”。最终请按照“新目录结构可解释，所有移动都有旧新路径映射，构建和引用检查没有新增错误”列出验收结果和仍需人工确认的内容。
实际使用时把示例中的材料名替换成你的真实文件，同时保留“不要补造缺失信息”和“列出待确认项”两条约束。
常见问题与报错
两个文件名相同，但内容和用途不同
不要按文件名判断重复；比较内容哈希、尺寸、引用位置和业务用途，无法确认时分别保留并加上可识别名称。
任务跑了很久，却说不清改了什么
先要求列出计划和预计修改文件，每个阶段输出变更摘要、diff、命令和未解决项；没有检查点的长任务应暂停后重新拆分。
一次修改太多文件，出现问题无法定位
回到版本控制或副本，按一个目标一组文件重新执行；每批修改后立即运行对应检查，不把多个不相关需求放进同一次任务。
排查时先看实际读取文件、修改diff、命令和输出。一次只调整一个范围或规则，避免把多个故障叠在同一次执行里。
完成后的检查方法
- 新目录结构可解释，所有移动都有旧新路径映射，构建和引用检查没有新增错误
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本，敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅，而不是只看页面是否生成。
工具负责推进，人负责边界和最终判断。把两者分清，这项工作才会越做越省时间，而不是越积越乱。
资料来源
- OpenAI Codex文档
用于核对Codex的产品定位和当前官方使用说明。
- OpenAI AGENTS.md指南
用于核对项目级规则文件的作用范围；具体行为以当前Codex版本为准。
FAQ
可以一次把整个任务交给Codex完成吗？
不建议一次交付全部范围。先按本文步骤完成一个小样，用“新目录结构可解释，所有移动都有旧新路径映射，构建和引用检查没有新增错误”验收，再决定是否扩大范围。
遇到“两个文件名相同，但内容和用途不同”应该先检查什么？
不要按文件名判断重复；比较内容哈希、尺寸、引用位置和业务用途，无法确认时分别保留并加上可识别名称
完成后还需要人工检查吗？
需要。AI或执行工具负责推进流程，最终仍要由你根据原始材料、任务规则和“新目录结构可解释，所有移动都有旧新路径映射，构建和引用检查没有新增错误”完成验收。