用途：当出现失败、报错、抛异常或行为异常，且原因不明显时，运行 /debug 找出并修复缺陷的根因。它把缺陷当作需要证明的案件，而不是急于消除的症状。
主要能力：按固定循环推进，复现、定位、提出假设、验证假设、修复根因、验证结果。一次只验证一个假设，每个假设都由证据确认或否定后再继续。定位阶段可用二分法缩小代码路径、用 git bisect 或 git log -p 查找引入变更、在边界处读取真实输入输出值。修复阶段只做针对已证实原因的最小改动，遵循项目约定（如 AGENTS.md 与相邻代码）。验证阶段重跑复现、跑周边测试、补充回归测试，并检查同一根因是否隐藏在其他位置。
使用方式：直接运行 /debug。它会主动复现、调查和修复，不请求调查许可；只有在无法从已有信息复现时，才询问确切步骤、输入、环境以及观察到的与预期的行为差异。命令为参考，应使用项目真实的测试与运行命令。可在子代理中运行，模型显式指定为强模型（Claude Code 用 sonnet），工具为 Read、Bash、Grep、Glob、Edit、Write，并要求报告根因与证据。
适用场景：测试因不明显原因失败、间歇性缺陷、回归问题、需要证明根因而非猜测的排查。
限制：不添加功能、不重构无关代码、不重写 ADR。若缺陷暴露的是决策缺陷而非编码错误，会指出并建议改用 /architect。它是一次运行内的调查循环，不是按时间间隔重跑命令的 /loop；需要长期观察（如反复轮询不稳定测试）时才用 /loop。输出一律使用简单平实的语言，不使用任何破折号。若无法复现，会添加埋点捕获并说明，不做盲目修复。