在现有代码库中安全地让 Codex 改代码

适用场景

项目已经存在，你需要修改某个页面、修复一个功能或调整一处逻辑，而不是从零开始新建项目。

输入

• 仓库当前状态：分支、未提交修改、构建命令和测试命令。
• 明确的目标：这次要改变什么行为，不改变什么行为。
• 不可动文件：配置文件、密钥相关文件、生成目录和用户自己的修改。
• 验证方式：git diff --check、单元测试、构建命令或浏览器检查。

工作流

先看仓库现状 → 列出改动方案 → 按文件或功能小步修改 → 查看 diff → 运行测试与构建 → 人工确认。

工具组合

Codex 负责定位相关代码、提出修改并执行验证；Git 用于查看每次改动边界和回退；你负责确认改动是否符合预期，并保留自己未提交的修改。

操作步骤

1. 执行 git status --short，先确认仓库里有没有你未提交的修改。
2. 让 Codex 先读相关文件，说明它计划改哪些文件和函数。
3. 把一次大改动拆成多个小改动，例如先改数据层，再改页面。
4. 每轮修改后检查 git diff，删除调试代码和无关格式化。
5. 运行测试与构建，确认没有破坏已有行为。
6. 在浏览器或实际使用路径中验证用户可见结果。

可用指令

这是现有项目，请按以下规则修改代码。

目标：{要改变的行为}
不改变：{已有功能 / 页面 / 接口}
相关文件：{你已找到的线索}
不可修改：{生成目录、密钥、用户未提交文件}
验证：{测试命令、构建命令、浏览器路径}

请先给出修改计划，逐项列出文件、改动内容和回归风险；确认后每次只改一个功能。

验收标准

• 修改范围只覆盖任务相关文件。
• 没有覆盖仓库中已经存在的未提交修改。
• git diff 清晰可读，没有无关重构和调试输出。
• 测试、构建和人工路径验证均通过。

风险提醒

不要让 AI 执行 git reset --hard、git checkout -- 或强制覆盖远程历史。遇到与用户修改冲突时，应先说明冲突，而不是直接覆盖。代码改动越集中，越容易确认和回退。