让 Codex 正确理解仓库

从结构到证据

有效调查从仓库根目录、构建命令和测试入口开始，再沿着调用关系缩小范围。一次性读取整个仓库会浪费上下文，还会让重要约束被噪声淹没。

要求 Codex 先说明它查看了哪些文件、观察到什么证据、还存在哪些未知。这样你能及时发现它是否在错误目录或错误分支上工作。

1. 检查 Git 状态，识别用户已有改动。
2. 读取 README、AGENTS.md 和项目配置。
3. 用文件搜索定位入口、类型和测试。
4. 运行最小复现或只读诊断命令。
5. 用证据更新假设，再决定修改范围。

保护现有改动

脏工作树中的未提交内容属于用户。代理应避开无关差异，不能用破坏性命令覆盖它们。需要隔离大任务时优先创建分支或 worktree。

如果目标文件已经有不相关改动，应先判断能否精确编辑。无法安全分离时，需要把冲突点交给用户决定。