Codex 把改动 commit 到了错误分支（甚至直接 main）
Codex 把活落到了 main、落到遗留分支、或拆成两半——因为云端任务默认用仓库的默认分支，本地 worktree 又会撞名。怎么强制每个任务跑在干净的独立分支上，以及 commit 已经落错地方时怎么救回来。
🛠️ 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 遇到 merge conflict 就卡住或瞎选边：rebase 策略和 AGENTS.md 兜底
Codex 撞上 conflict marker 要么停下、要么挑错边、要么把 marker 直接写进文件。任务前 rebase、把 rebase 放进 setup 脚本、AGENTS.md 停机规则加 pre-commit hook，一起解决。
Codex 加了包但 lockfile 没动：怎么强制同步更新
Codex 改了 package.json 却没跑 npm install，package-lock.json 和真实依赖分叉、npm ci 直接挂。用 setup.sh、CI 同步检查和 AGENTS.md 规则一次性根治。
Codex 的修复测试全绿，运行时一上线就崩
Codex 的 PR 在 CI 里全绿，但部署后应用就崩。为啥 agent 修复打中的是测试面而不是 runtime，以及那道能补上 gap 的 smoke 关卡。
Codex 又造了一个和现有类型重名的 interface：怎么让它先搜再写
Codex 新建了一个 User 或 ApiResponse 类型，其实仓库里已经有一份一模一样的。用 AGENTS.md、types barrel、ripgrep 和 ts-morph CI 检查强制它先搜。
Codex 自作主张改了 git history：amend / rebase / force-push 怎么禁掉
Codex 跑了 git commit --amend、交互 rebase 或 force-push，重写了共享分支的 history。用 AGENTS.md、sandbox network 开关和 GitHub ruleset 把 agent 锁死在 forward-only commit 上。
Codex 写的 PR 描述太敷衍：怎么逼出结构化 before/after
Codex 的 PR body 只有一句 "重构组件"。如何用 PR template + AGENTS.md + CI 关卡逼出 before/after、why、test plan，外加 Codex Cloud 按钮的坑。
Codex 说 "测试通过"，其实跳过了失败用例：如何强制诚实报告
Codex 报告测试全绿，但失败的 case 被 .skip 了、被 --bail 提前结束了、或者根本没跑完。如何在 merge 前强制看到真实结果。
Codex 大 diff 跑一半就停：怎么把活干完
Codex 撞上 context 上限就停，留下半个 patch。把任务窄到一个动词、拆成多 PR、调 auto-compaction、用 resume note 续上——配置以 2026 年 6 月为准。
让 Codex 别再写 componentWillMount 这类废弃 API
Codex 因为训练数据滞后会注入多年前就废弃的 API。用 AGENTS.md 规则、@typescript-eslint/no-deprecated lint 规则和最新参考文档，把它锁到现代写法。
Codex Agent 输出与 Prettier 冲突：6 个原因 + format-in-loop 模板
Codex 写完文件、Prettier 保存时重排，diff 变 5 倍。修法是在 agent 循环里跑项目锁定的 Prettier、AGENTS.md 风格对齐 .prettierrc。
Codex Agent 在大仓库里失去上下文：原因排查 + scope 收敛方案
50 万 + 行的项目里 Codex 跑到一半就晕了。修法是先界定 working set、预喂目录摘要，并把约定放进 AGENTS.md，让它能扛过 compaction。
Codex Agent 静默跳过含二进制数据的文件：7 个原因 + probe 替代方案
Codex 把 PNG / PDF / sqlite / 编译产物从审计里悄悄丢掉。修法：用 file + wc -c + sha256sum 探测二进制、文本扩展名 allowlist、强制不可省略的输出 schema。
Codex Agent 调用工具次数失控：6 个原因 + 最快修法
Codex 同一个文件读 8 次、同一个 grep 跑 5 次。最快修法：先跑 /plan、加一份 AGENTS.md 结构图、把 reasoning effort 保持在 medium。完整诊断见下。
Codex 任务跑到一半静悄悄停下：原因排查与续跑方案
Codex 多步任务跑到一半停下、不报错——通常是上下文 compaction 把后半段计划裁掉、sandbox/审批被拒、或 stop 信号误命中。先看最后一次 tool call，再用 codex resume --last 续跑。