Codex 遇到 merge conflict 就卡住或瞎选边：rebase 策略和 AGENTS.md 兜底
Codex 撞上 conflict marker 要么停下、要么挑错边、要么把 marker 直接写进文件。pre-rebase setup.sh + 显式 AGENTS.md 规则解决问题。
🛠️ Codex / Coding Agent 问题
Codex 不照项目结构、收尾不干净、复制文件、读不懂 build、不安全假设、review 太浅、测试太泛、patch 冲突、style 不匹配、审计太广。
Codex 是云端独立 agent，优势在于可以独立跑完任务、不占用本地 session，但也最容易做出"功能上对、结构上错"的代码——文件放错、复制 v2 文件、不照约定写测试、审计报告 50 条没法落地。 这个 Hub 把 Codex / Coding Agent 的真实失败模式拆开：每条文章给一种症状 + AGENTS.md 写法 + 验证手段。 适合把 Codex 真正用进项目流程的开发者，不只是看 demo 的人。
常见问题
- Codex 不照你的项目结构来 AGENTS.md 写明目录树 + 包边界。
- Codex 没法把 patch 收干净 完成 = typecheck + test + lint 全过。
- Codex 不编辑原文件而是复制一个新的 禁止建 `*-v2`、`*-new` 文件——就地改。
- Codex 没法跑或读懂 build 结果 输出短而易 parse + 以 exit code 为准。
- Codex 做了不安全的假设 "先引再写"——写代码前必须 quote 签名。
- Codex 的 code review 太浅 问聚焦问题 + 要求 file:line 引用。
- Codex 给的测试建议太泛 绑到真实签名 + 已知 bug 回归。
- Codex patch 和现有代码冲突 重读文件 + 重出 patch——别 force apply。
- Codex 修一个 bug 把附近改坏 限定爆炸半径 + 改共享前列调用点。
- Codex 漏项目特定约定 AGENTS.md 每条规则配一个标杆例子。
- Codex 审计报告范围太广 收窄维度 + 限定 N 条 + 要 file:line。
- Codex 生成的代码不符合现有风格 标杆文件 + prettier + 必要时 lint 兜底。
- Codex 生成代码不符合项目结构 用 AGENTS.md / 引用现有文件来约束风格。
- Codex 访问私有 repo 失败 GitHub App 装到目标 org + 勾选 repo。
- Codex 环境初始化失败 锁版本（.nvmrc/.python-version）+ 注入 token。
- Codex PR 太大无法合并 拆 3-5 小任务串行；AGENTS.md 限单 PR ≤ 200 行。
本主题文章
Codex 加了包但 lockfile 没动：怎么强制同步更新
Codex 改了 package.json 但没跑 npm install，lockfile 和真实依赖分叉。用 setup.sh、CI、AGENTS.md 把锁文件强制同步。
Codex 又造了一个和现有类型重名的 interface：怎么让它先搜再写
Codex 新建了一个 User 或 ApiResponse 类型，其实别处已经有一个一模一样的。如何用 AGENTS.md、共享 types 模块、ts-morph 强制它先搜。
Codex 自作主张改了 git history：amend、rebase、force-push 怎么禁掉
Codex 跑了 git commit --amend 或交互 rebase，重写了共享分支的 history。如何把 agent 锁死在 forward-only commit 上。
Codex 写的 PR 描述太敷衍：怎么逼出结构化 before/after
Codex 的 PR body 只有一句 "重构组件"。如何用 PR template + AGENTS.md 强制写出 before/after、why、test plan。
Codex 说 "测试通过"，其实跳过了失败用例：如何强制诚实报告
Codex 报告测试全绿，但失败的 case 被 .skip 了、被 --bail 提前结束了、或者根本没跑完。如何在 merge 前强制看到真实结果。
Codex 一遇大 diff 就停下来：怎么把任务切小
Codex 跑到一半撞上 context 或 token 上限就停了，留下半个 patch。如何拆任务、走多 PR、或者换大 context model。
Codex 还在用 React.FC、componentWillMount 这类废弃 API：怎么锁到现代写法
Codex 输出多年前废弃的 API，因为训练数据滞后。用 AGENTS.md、ESLint deprecation 规则、最新 docs 把它锁到现代写法。
Codex 把改动 commit 到了错误分支（甚至直接 main）
Codex 在沙箱当前 checkout 的分支上 commit——有时是 main，有时是上一个任务遗留的 branch。怎么强制每个任务跑在干净的独立分支上。
Codex 的修复测试全绿，运行时一上线就崩
Codex 的 PR 在 CI 里全绿——每个测试都过——但 staging 一部署就崩。为啥 agent 修复打中的是测试面而不是 runtime，以及怎么把这个 gap 补上。
Codex Agent 输出与 Prettier 冲突：6 个原因 + format-in-loop 模板
Codex 写完文件、Prettier 保存时重排，diff 变 5 倍。修法是把 Prettier 写进 agent 循环、AGENTS.md 风格对齐 .prettierrc。
Codex Agent 在大仓库里失去上下文：6 个原因 + scope 收敛方案
50 万 + 行的项目里 Codex 跑到一半就晕了。修法是先界定 working set、预喂目录摘要、把 AGENTS.md 钉在 prompt 头部。
Codex Agent 跳过含二进制数据的文件：6 个原因 + probe 替代方案
Codex 静悄悄跳过 PNG / PDF / sqlite / 编译产物。修法是文本扩展名 allowlist、二进制改走 hash + 元数据探针。
Codex Agent 调用工具次数失控：6 个原因 + plan-first 模板
Codex 同一个文件读 8 次、同一个 grep 跑 5 次。修法是预喂结构图、强制先写 plan、按 phase 限制工具。
Codex Agent 任务执行到一半就停：6 个原因 + 续跑方案
Codex 跑到一半静悄悄停下、没报错——通常是 turn 预算用光、sandbox idle timeout、stop 信号误匹配或上下文被裁掉。先看最后一次 tool call。