用途：当失败原因不确定时，用证据定位失败边界并修复根因，同时保留原有业务意图。已知原因的修复通常不需要本流程。
主要能力：捕获失败命令或流程、输入、预期行为、实际结果与相关环境；先读错误与附近源码再扩大搜索；尽量复现最小可用案例；若无法复现，区分日志或源码能证明的内容与仍属假设的部分；沿受影响边界追踪症状，选择能区分可能原因的检查，安全的独立观察可并行；避免叠加推测性修复。UI 失败时检查提供的图像或渲染状态，仅在能实质消除歧义时标注副本。
使用方式：默认在主对话中运行。委派子代理可能增加用量，需先就拟用代理数量与范围获得明确批准，并在批准范围内复用；扩大数量或范围前需再次询问。更深入的隔离、偶发失败或临时插桩可阅读 debugging-playbook.md。
修复与验证：做最小且连贯的修复，除非证据表明异常业务规则本身是缺陷，否则予以保留；避免无关重构。在能提供持久保护时添加回归测试，最好先展示修复前的失败。重跑原始失败与受影响检查，完成仓库要求的检查；仅在剩余风险需要且授权允许时扩大范围，可复用仍有效的结果。若测量或测试设计成为主要工作，可直接查阅相关专业指南。
报告：说明原因、修复及失败已解决的证据，包含复现限制或剩余不确定性。仅在后续工作受益时，把疑难缺陷记录到现有持久文档中。
限制：日志中不得包含敏感数据，需移除临时调试代码；子代理使用受批准范围约束。其他细节暂未提供。