#Coding Agent - 标签 | AI 工具指南

常见问题解决库

Codex 给你回了 50 条 audit，从 typo 到架构混在一起——按维度收窄、限输出大小、强制 file:line。

常见问题解决库

Codex 半路停手——import 缺失、类型只换了一半、call site 没改全。把「done」绑到 verifier 上，不要绑到 vibe 上。

常见问题解决库

Codex 在 `utils.ts` 旁边新建 `utils.v2.ts` 而不就地改——用 AGENTS.md 规则 + git 兜底强制就地编辑。

常见问题解决库

Codex 跳过 build、误读输出、相信被截断的 tail——用机器可读的 verifier + exit code，不要看 prose 总结。

常见问题解决库

报的 bug 修好了，相邻两个功能挂了——限定改动范围、强制 caller 清单、优先在调用方加 guard 而不是改共享 util。

常见问题解决库

新文件落到 `/src/` 但你的 repo 用 `/app/`；monorepo 里依赖被加到根 `package.json`；测试用了你没装的框架——用 AGENTS.md + canonical example 指针修。

常见问题解决库

Codex 自信地用了不存在的列、错的环境变量、没读过的函数签名——强制 quote-before-write 接地。

常见问题解决库

Codex 用 `getUserById`，但你的项目用 `findUserById`——每条约定都要在 AGENTS.md 里配一个 canonical example 文件。

常见问题解决库

「Patch hunk failed to apply」——Codex 读时和写时文件不一样。修 state drift，不要硬塞 patch。

常见问题解决库

「考虑下错误处理」「补一下测试」——任何 PR 都能套上的话——用 file:line 锚定的具体问题修。

常见问题解决库

代码能跑，但读起来像陌生人写的——async/await 混 .then()、import 顺序错、注释风格不对。指向 canonical 文件 + lint 强制。

常见问题解决库

「测一下 happy path 和 error path」——2026 年没用——把测试绑到函数的真实签名、真实类型、过去的真 bug 上。