在 Codex 完成代码修改并通过初步验证后，直接进行 git commit 往往存在隐患。Git 提交前审计 是确保代码质量、保持提交历史整洁的关键步骤。

为什么需要提交前审计？

  • 识别非预期改动：AI 可能会在不经意间修改了格式、删除了注释或更改了无关的配置文件。
  • 优化提交信息：利用 AI 总结改动点，生成符合团队规范的 Commit Message。
  • 安全性检查：最后一次确认代码中是否包含硬编码的密钥或敏感测试数据。

审计操作流程

1. 显式要求 Diff 说明

在任务结束前，要求 Codex 汇报具体的改动明细：

> “请按文件列出本次任务的所有改动点，并特别指出是否有任何非功能性的修改（如格式调整）。”

2. 交互式 Diff 检查

使用 IDE 的 Git 工具或命令行 git diff 逐行查看改动。重点检查：

  • 导入项 (Imports)：是否有冗余或错误的包导入。
  • 调试日志：是否有遗留的 console.log 或 print 语句。
  • 逻辑边缘：改动是否破坏了原有的缩进或括号匹配。

3. 利用 AI 生成 Commit Message

您可以驱动 Codex 基于当前的 Diff 生成专业的提交信息：

> “请根据目前的改动情况，生成一条符合 Conventional Commits 规范的提交信息。格式要求：(scope): 。”

常见审计发现与对策

| 发现问题 | 处理建议 |

| :--- | :--- |

| 越界修改 | 使用 git checkout 回滚无关文件的改动。 |

| 格式化噪音 | 如果项目有 Prettier/ESLint，运行 npm run lint 修复后再审计。 |

| 描述不符 | 要求 Codex 重新解释改动逻辑，直至描述与代码完全吻合。 |

审计闭环标准

只有满足以下条件，才允许执行提交：

  1. Diff 差异完全符合任务 Scope。

    2. 2. 所有自动化检查（Lint/Test）均在改动后再次通过。

    3. 提交信息准确描述了变更的本质。

    ---

    下一步：自动化检查 —— 学习如何将审计过程自动化。