用途：当缺陷原因未知、只知道“坏了”时，用 /diagnose 做只读调查，而不是直接改代码。已知根因的修复用 /fix，单行小补丁用 /quick。
主要能力：主代理负责编排与汇总，另起一个全新 200k 上下文的调试子代理（Task 工具）并行执行 /review solve 伴随分析，从架构角度给出第二意见；调试会话写入 .claude/debug/<slug>.md，可跨上下文压缩存活并恢复。
使用方式：/diagnose "auth token not working" 新建会话；--resume <slug> 恢复；--list 列出活动会话；--close <slug> 标记已解决；--issue 42 从 GitHub issue 拉取症状，也可与自由描述组合。流程为收集症状（预期、实际、报错、时间线、复现步骤）、triage 相关文件（约 20 个以内）、初始化会话文件、并行调查、汇总结果、评估迭代、交接与关闭。若 sonnet 两轮迭代假设全部被否，自动升级到 opus 子代理；仍无结论则请用户提供人工调查输入。
适用场景：根因不明的缺陷调查，尤其是需要隔离上下文、保留假设记录、需要架构层面第二意见的情况。
限制：只读调查，不产生代码改动；不自动调用 /fix，由用户决定后续；会话文件位于 .claude/debug/ 且已被 gitignore，不应提交。资料未提供收费、价格与平台支持信息。