报错时该给 AI 哪些材料，才能得到可验证的修复

给 AI 的第一份材料应该是复现包

完整错误、发生步骤、环境版本、最近改动和期望结果比“帮我修一下”重要。先证明问题稳定发生，再让修改围绕一个可验证假设。

记录最小复现

从干净起点写命令或点击步骤、输入、实际结果和期望结果，确认是否每次发生。

把涉及的文件、目录、版本、命令和实际输出写进记录；代码变化同时保留 diff 与测试结果。

保存完整错误

不要只截最后一行；保留时间、退出码、堆栈、请求 ID、相关日志和首次异常。

确认“保存完整错误”已经有可回查结果，再进入“补环境与变化”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

补环境与变化

写系统、运行时、依赖、分支、配置来源和最后一次可用版本，列最近实际 diff。

确认“补环境与变化”已经有可回查结果，再进入“形成单一根因假设”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

形成单一根因假设

说明证据为何指向某层，以及怎样用最小实验证伪；不要同时改依赖、配置和代码。

确认“形成单一根因假设”已经有可回查结果，再进入“修复后跑三类验证”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

修复后跑三类验证

重跑原复现、目标测试和相邻回归，记录前后输出与回滚方式。

需要修改时先限定文件和行为范围，无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“复现包：命令、版本、完整错误和最近改动”。

修复说明必须回答“为什么好了”

交付根因证据、最小改动、验证和残余风险。错误暂时不出现但无法解释变化，只能标为未复现或缓解。