Aider 多文件重构教程：函数改名与旧入口兼容检查

1. 下载并复现基线

把 lesson.zip 解压到独立目录，阅读 before/app.py 和 test_app.py。运行前版测试，保存退出码；本任务目标是：在三文件练习中新增清晰函数名，保留旧调用兼容并更新内部导入；核对调用者、测试与 diff 文件集合。

cd before
python3 -m unittest -v

2. 在工具中限定上下文

在 Aider 使用 /add app.py consumer.py，/read-only test_app.py README.md；先核对可改文件集合，再要求引入 normalize_sku 并保留 clean 兼容入口。添加文件不代表可以修改只读测试。

3. 提交明确任务书

下载 prompt.txt，核对允许修改的文件后提交给 Aider。参考实现只作为对照，先自己完成任务，不把教材补丁冒充工具生成。

将内部调用更新为 normalize_sku，并保留 clean 作为兼容 wrapper。只允许 app.py、consumer.py 两文件变化；不要修改 tests。检查所有调用入口。

4. 逐文件查看差异

对照 reference.patch 检查逻辑与公开接口。若工具改动测试以绕过错误，先恢复测试；只看“完成”提示不能确认行为正确。

git diff -- app.py

5. 运行本任务的原始检查

运行新旧函数入口及 consumer 的原测试，再查看 git diff --stat：只有 app.py 与 consumer.py 允许变化。clean 保持包装兼容，内部调用改到 normalize_sku，不能通过修改测试隐藏旧入口断裂。

python3 -m unittest -v

6. 核对参考结果与负例

教材 verify.py 会读取 before/fixed 的真实文件并执行 unittest，然后在临时副本中故意破坏代码，确认测试返回非零。已真实运行 Python 标准库测试、参考补丁与负例拒绝；未执行 Aider 模型会话。

python3 verify.py

7. 保存练习结果

记录自己的工具版本、实际修改 diff、测试退出码和仍需人工复核的点。init-git.py 只初始化下载包里的 before 目录，不触碰其他仓库；在确认当前练习文件后运行。

python3 init-git.py

怎样确认已经完成

• 自己的修改通过相同测试，不能修改测试绕过错误。
• diff 只包含任务允许的文件，并保留未要求修改的接口。
• 已真实运行 Python 标准库测试、参考补丁与负例拒绝；未执行 Aider 模型会话。

常见问题

资料来源

• Aider：/add 与 /read-only