用途：当智能体运行反复失败、消耗 token 却无进展、在同一工具上循环或偏离原任务时启用。它是工作流技能而非隐藏运行时，教智能体在求助人类前系统自调试。
适用触发：工具调用达上限或循环限制失败；重复重试无进展；上下文增长或提示漂移导致输出质量下降；文件系统或环境状态与预期不符；可通过诊断和小幅纠正恢复的工具失败。
四阶段循环：一、失败捕获，记录错误类型、消息、堆栈、最后有效工具调用序列、目标、上下文压力与环境假设，使用给定捕获模板。二、根因诊断，将失败匹配已知模式（如最大工具调用/重复命令、上下文溢出、ECONNREFUSED/超时、429/配额耗尽、写入后文件缺失、修复后测试仍失败），并回答是逻辑、状态、环境还是策略失败等问题。三、受控恢复，采取改变诊断面的最小动作，如停止重试、精简上下文、核对真实文件/分支/进程状态、缩小任务范围、从推测转为直接观察，高风险或外部阻塞时升级人类；不得声称未实际执行的自动修复。四、自省报告，输出失败、根因、恢复动作、结果、token/时间消耗风险、后续事项与预防性变更。
恢复启发式顺序：一句话重述真实目标、验证世界状态而非依赖记忆、缩小失败范围、运行一次判别性检查，之后才重试。
集成：代码变更后用 verification-loop；值得沉淀为直觉或技能时用 continuous-learning-v2；非技术性决策模糊时用 council；本地状态冲突或仓库漂移时用 workspace-surface-audit。
限制：不用于代码变更后的功能验证、已有更窄 ECC 技能覆盖的框架调试，或当前运行环境无法自动执行的运行时承诺。输出标准要求不能只说“已修复”，须给出失败模式、根因假设、恢复动作及情况改善或仍阻塞的证据。