项目实践：规则、检查与验收

开始前，保存一个可回到的版本

已有项目先确认当前改动来自哪里，保存可用版本。使用 Git 的项目，可以先检查当前状态，再按自己的流程提交或备份；不要把他人未完成的修改混进本次任务。

不熟悉 Git 时，先备份练习文件夹。正式项目应了解自己的版本保存和回退流程。

git status
git diff

把重复规则放进 AGENTS.md

在项目里记录长期适用的规则，例如启动和测试命令、允许修改的目录、需要保持的技术栈。Codex 会按官方说明发现并读取 AGENTS.md；子目录规则及覆盖顺序见官方参考。

# 项目约定

- 修改前先阅读 README，沿用已有代码风格和技术栈。
- 新功能只修改与任务有关的文件。
- 检查命令以 README 中的实际命令为准；不要编造测试通过的结果。
- 不把密码、token 或真实用户数据写入代码和日志。
- 完成后说明修改内容、验证结果与未验证事项。

一次只推进一个能检查的变化

1. 理解现状

   让 Codex 阅读项目规则和相关文件，说明当前行为与本次需求的关系。

2. 明确改动

   给出具体目标和保留范围；涉及多个模块时，先确认实现顺序。

3. 实现并检查

   完成修改后，运行与变化有关的检查。页面变化实际打开验证，业务行为检查正常和关键异常输入。

4. 查看差异并验收

   核对修改文件、实际 diff、检查输出和试用结果。确认符合需求后，再按自己的流程提交或发布。

让它给证据，再决定是否采用

代码数量多，不代表任务完成。让它解释具体行为变化、检查结果以及实际无法验证的部分；你仍需核对关键操作与业务数据。Git 项目还可使用客户端支持的 /review 检查选定范围的变更。

请总结本次修改：
1. 哪些文件变了，分别解决什么问题。
2. 实际运行了哪些检查，结果是什么。
3. 有哪些内容没有验证，为什么。
4. 我怎样手动检查核心功能和一个关键异常情况。
不要把未运行的测试写成通过；暂不提交或发布。