XIAOHU AI ACADEMY · C01 · 参考样例
一次合格的故障恢复,和一本会长大的排错手册
本课交付:故障演练记录.md(保存错误 → 分类 → 最小修复 → 复跑)和 我的排错手册.md(第一条真实案例 + 空白模板)。
📄 故障演练记录.md2026-07-17 · 演练场:毕业压力测试/缺素材/
现象与完整错误(原样保存,不转述)
输入检查停止:毕业压力测试/缺素材/ 缺少 03-物料清单.csv。
已检查路径:毕业压力测试/缺素材/(应有 4 份,实有 3 份:01-基本信息.txt、02-流程安排.csv、04-现场提醒.txt)。
按蓝图停止条件「缺输入文件即停止」终止;未生成报告,未从其他目录取数据。
故障分类
- 输入层——不是启动问题(claude 正常运行)、不是权限问题(没有权限报错)、更不是质量问题(根本没走到产出)。
检查过的证据
- 对比
毕业压力测试/正常/与缺素材/的目录清单,锁定缺的就是 03; - 指挥中心「素材完整」状态灯变红(10:05 检查刷新)——报警是真实检查驱动的,不是演的。
最小修复(一次只改一个地方)
- 只从
毕业压力测试/正常/复制03-物料清单.csv到缺素材/;没有动其他文件,没有碰正式素材。
复跑结果
- 只重跑失败的那一步(输入检查)→ 10:12 通过;状态灯 10:13 复绿。没有顺势跑完整流程——成功标准就到输入检查为止。
本次明确没有做的动作
- 没有重装 Claude;没有放宽权限模式;没有改任务提示词;没有从正式
开放日素材/取文件;没有继续跑并行检查。
📄 我的排错手册.md2026-07-17 创建 · 只写真实发生过的
先按现象找方向
- 终端找不到 claude → 启动层,先跑
claude --version/claude doctor; - 任务说找不到素材 → 输入层,先对目录清单;
- 写文件被拒绝 → 权限层,查权限模式和允许写入的路径;
- 文件生成了但内容不合格 → 质量层,回检查规则和证据。
第 1 条 · 任务说找不到素材(输入层)
- 我看到的现象与完整错误:见 故障演练记录.md 的原文摘录;
- 故障属于哪一层:输入层;
- 我检查过的证据:正常目录 vs 故障目录的文件清单对比;
- 最小修复:只补回缺失的那一个文件;
- 复跑到哪一步算恢复:输入检查重新通过即恢复;
- 这次明确没有做:重装、放权限、改提示词、动正式素材。
空白模板(以后每次故障照抄一份往下填)
- 第 N 条 · (现象标题)
- 我看到的现象与完整错误:___
- 故障属于哪一层(启动 / 输入 / 权限 / 质量):___
- 我检查过的证据:___
- 最小修复(一次只改一个地方):___
- 复跑到哪一步算恢复:___
- 这次明确没有做的动作:___
对照要点 — ①错误必须原样保存,转述会丢线索;②「没做什么」和「做了什么」一样重要——慌乱时最容易同时改五个地方,记录里写明没做的动作,就是给下次的自己立规矩;③复跑只到失败的那一步,不顺势跑全程;④手册必须带空白模板,否则第二条永远不会被写下来。