本案例介绍如何驱动 Codex 对项目中的遗留模块或冗余逻辑进行受控的重构，在不改变业务表现的前提下提升代码质量。
1. 任务背景
项目中的 OrderService 存在大量的硬编码字符串和重复的金额计算逻辑，导致代码难以维护且容易出错。
2. 第一步：重构前的只读审计
重构的第一步永远是“理解”，而不是“修改”。
Prompt 示例：
``text
请先只读分析 OrderService.java，不要修改文件。
要求：
- 识别出所有重复出现的硬编码字符串。
- 将金额计算逻辑提取到 PriceUtils
工具类中。 - 运行项目现有的单元测试 OrderServiceTest
。 - 逻辑一致性：重构前后的 API 响应数据完全一致。
- 改动审计：通过 git diff` 确认只有目标逻辑被移动，没有非预期的逻辑变更。
2. 找出可以提取为私有方法或常量类的冗余计算逻辑。
3. 对比项目现有的 AGENTS.md 架构规范，指出当前实现中不合规的地方。
`
3. 第二步：制定原子化重构方案
重构必须是小步快跑的，严禁一次性重构整个模块。
Prompt 示例：
`text
请给出最小化重构方案：
2. 将状态字符串提取到 OrderStatusEnum 枚举类中。
3. 目标是提升可读性，严禁改变现有的业务逻辑。
请先输出重构计划，包含受影响的文件列表。
`
4. 第三步：执行修改与质量守门
在修改过程中，利用 AI 的检查能力守住底线。
Prompt 示例：
`text
请按计划执行重构。
修改后请立即：
2. 检查改动是否引入了新的 Linter 警告。
3. 确认没有“顺手”修改无关的公共配置。
`
5. 验收标准
---
下一篇推荐：实战案例：用 Codex 做一次代码审查 —— 学习如何让 AI 担任您的首席代码评审员。