在Codex中为每项删除操作添加说明理由是为了保障代码变更可追溯、可审查，避免被误判为疏漏；可通过Web界面手动补全、Git提交信息批量绑定或启用预提交钩子强制校验三种方式实现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Codex中为每项删除操作添加说明理由，是为了让代码变更可追溯、可审查，避免后续维护时无法理解某行代码为何被移除。缺少理由的删除容易被误判为疏漏或错误，尤其在团队协作或审计场景下会直接导致质疑。
使用Codex Web界面手动补全删除理由
打开Codex项目页面→点击左侧导航栏「Changes」→找到目标commit记录→点击进入该次提交详情页。
在「Deleted lines」区块中，每条被删代码右侧默认为空白；将光标移至某行末尾→按Tab键→输入简明理由，例如“移除过期的兼容性兜底逻辑”或“替换为统一错误处理模块”。
注意：理由必须写在删除行右侧同一行内，不能换行，否则Codex不会识别为关联说明。
通过Git提交信息批量绑定删除依据
方法一：本地修改后提交时用-m参数内嵌说明
git commit -m "refactor: 删除useLegacyAuth.js → 【因SSO已全量上线，该文件无任何调用】"
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法二：交互式提交，确保每个删除动作对应一条body条目
git commit --edit → 在commit message body中逐条列出：
① 删除src/utils/date-fns-polyfill.js → 已由v3.0内置API替代
② 删除test/e2e/old-login.spec.js → 对应流程已迁移至Cypress新测试套件
Codex会自动解析Git commit body中的结构化条目，并将其映射到对应删除行旁。
启用Codex预提交钩子强制校验
在项目根目录运行：npx @codex/cli init-hooks --enforce-delete-reason
该命令会在.git/hooks/pre-commit中注入校验脚本，检测本次提交中所有被删除的非空行——若任一删除行未在相邻注释、commit message或专用reason.json中声明依据，提交将被中止并提示缺失位置。
这一步不可跳过，否则无法触发Codex后台的理由归档机制。
