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 条 · (现象标题)
  • 我看到的现象与完整错误:___
  • 故障属于哪一层(启动 / 输入 / 权限 / 质量):___
  • 我检查过的证据:___
  • 最小修复(一次只改一个地方):___
  • 复跑到哪一步算恢复:___
  • 这次明确没有做的动作:___
对照要点 — ①错误必须原样保存,转述会丢线索;②「没做什么」和「做了什么」一样重要——慌乱时最容易同时改五个地方,记录里写明没做的动作,就是给下次的自己立规矩;③复跑只到失败的那一步,不顺势跑全程;④手册必须带空白模板,否则第二条永远不会被写下来。
返回本课