毕业项目 · 问题 3:出错以后,最怕一慌就同时改五个地方
任务说找不到素材,到底该重装 Claude、改提示词、开放更多权限,还是只补回那个文件?怎样避免越修越乱?
不要求你立刻看懂每一行英文。先保存完整报错,再判断问题出在工具启动、输入文件、权限还是成品质量。一次只改一个最可能的原因,然后只重新运行刚才失败的那一步。
- 01看到不同现象时,应该先检查启动、输入、权限还是结果质量?
- 02怎样保存错误、只修一个地方,并从失败步骤重新开始?
- 03怎样把这次真实经验写成下次能直接照着查的排错手册?
故障演练记录.md + 我的排错手册.md记录完整错误、故障分类、最小修复、复跑证据和本次明确没有做的动作。
01先根据你看到的现象,判断应该从哪一类问题开始检查
工具本身没启动时,不要去修改任务提示词。
证据:完整的命令输出或报错原文02真实演练:测试副本里缺少 03-物料清单.csv,先确认它会按规则停止
请只检查 毕业压力测试/缺素材/ 这套输入,按毕业项目蓝图的输入检查阶段执行。不要从正式素材补文件,不要猜物料数据,也不要修改测试目录。 停止后把完整错误、缺少的文件、已检查路径和建议的最小修复写入 故障演练记录.md。
检查位置:毕业压力测试/缺素材/
动作:停止;未复制正式数据;未继续生成报告
请对照 毕业压力测试/正常/ 的文件清单,只把缺少的 03-物料清单.csv 复制到 毕业压力测试/缺素材/。不要复制其他文件,不要改正式素材。 然后重新运行输入检查。把修复动作、复跑结果和证据追加到 故障演练记录.md。成功标准只是“输入检查通过”,不要继续后面的并行检查。
演练时顺便刷新一次检查:第 1 次按规则失败后,把检查结果刷进开放日指挥中心,亲眼看它的状态灯变红;补回文件、复跑通过后再刷一次,看它复绿。这就是毕业演示的保留节目——当着人的面拿走一个文件,你的系统自己报警;放回去,它自己复绿。灯不是演的,是检查真跑出来的。
状态灯为什么会自己变红?
灯不认识“故障”,它只认检查结果。这条链在第 5 章就搭好了:检查任务读一遍素材清单和成品 → 把每项结果写下来 → 指挥中心的状态区按结果亮灯。文件缺了,检查那一项过不去,灯就红;文件回来了,下一轮检查通过,灯就绿。所以红灯不是页面在吓唬你,而是流程在替你盯着——这也是为什么骨架里不做“演示开关”:你的报警必须由真实检查驱动,假灯只会训练你忽略它。
03把这次真的遇到过的错误和解决办法写进自己的排错手册
请读取 故障演练记录.md,在项目根目录创建 我的排错手册.md。 第一条必须按这个结构写: - 我看到的现象与完整错误; - 故障属于哪一层; - 我检查过的证据; - 最小修复; - 复跑到哪一步算恢复; - 哪些动作这次明确没有做。 再加一个空白模板,方便我以后追加新故障。不要编写这次没有真实发生的问题。
只有错误被保存、正式素材没被修改、只补回一个文件,而且输入检查重新通过,才算恢复完成。
如果真正遇到 Claude 一直不动、无法启动或出现 429、5xx 等错误,先做什么
如果 Claude Code 还能打开,在会话里输入 /doctor,它会检查安装、设置、外部连接和当前会话信息。若会话根本打不开,就在终端运行 claude doctor。Claude 长时间没有反应时,可以先按 Ctrl+C 停止当前动作;重新启动后,在同一个项目目录运行 claude --resume,选择刚才的会话继续。看到 429、500、503 等接口错误时,先保存完整原文,再查看官方错误说明和服务状态,不要先重装全部软件。
/rewind 只能帮助撤回 Claude 使用文件编辑工具造成的改动。终端命令、你自己修改的文件和其他软件造成的变化不一定能撤回,所以它不能代替项目备份。最后一课不再增加任务。回到项目把这门课真正生成的文件逐项盘点,缺少就写缺少,需要复查就保留复查,再安排第一次真实迁移。
进入最后一课:整理结课交付清单 →最后验收
不要只确认“AI 说做完了”,请打开真实结果检查。
一次真实故障恢复记录,以及项目里的我的排错手册.md回到当前 AI 任务,请它打开本课成品;也可以在访达 / 资源管理器里进入项目文件夹双击。查看参考样例 ↗