用途：在修复 bug 前，先确认系统实际产生了什么，再决定是否修改代码。资料强调“输出不会说谎，代码可能会”，因此应先检查输出。
主要做法（DO）：检查预期目录是否存在，如 ls -la .claude/cache/；检查预期文件是否创建，如 ls -la .claude/cache/learnings/；查看日志错误，如 tail .claude/cache/*.log；手动运行失败命令以看到真实错误；完成这些之后再编辑代码。
避免（DON'T）：未检查输出就假设“hook 没有运行”；按“应该发生什么”的想象去改代码；混淆全局路径与项目路径，应同时检查 .claude/ 和 ~/.claude/。
来源会话示例：a541f08a 中，token 限制错误在手动运行前不可见；6a9f2d7a 中，因查看错误缓存路径（~/.claude/ 与 .claude/）而误判 hook 失败；a8bd5cea 中，通过项目缓存中的输出文件确认 hook 正常工作；1c21e6c8 中，通过检查 DB 文件是否存在来验证 Artifact Index 索引。
适用场景：调试 hook、缓存、日志、索引等系统行为，或任何“代码看起来对但结果不对”的排障过程。限制：资料未提供安装方式、平台支持、收费信息或更多实现细节。