用途：当 superpowers 会话出现重复工作、忽略计划、卡顿、结果差或某技能未触发等问题时，帮助定位并报告实际发生了什么。核心原则是每条发现都必须引用 path:line，所有数字来自会话记录或实际运行的命令，不凭记忆。
主要能力：按流程分步执行——问题确认（逐条提问，明确会话、轮次范围、预期、实际与关注指标）、定位会话文件（解析为绝对路径，引用首条提示与时间戳确认，枚举子代理记录，建立 ~/.superpowers/diagnosing-superpowers/<session-id>/ 并填写 case.md）、分诊（自行阅读问题区域，再按维度并行派发分析子代理，维度包括 skill-timeline、plan-adherence、repeated-work、stumbles、quality-evidence、request-conflicts、cost-and-time）、报告（按模板填写并展示路径）、GitHub issue（仅在报告 §7 提示可能或用户要求时，先搜索已有 issue，经批准后创建）、导出（仅在用户要求时构建脱敏 bundle，分 skeleton、evidence、full 三档，经 scrub 与审计 CLEAN 后归档）、相似会话查找（按需）。
使用方式：以技能形式调用，按步骤创建 todo；步骤 5–7 仅在各自条件满足时运行。子代理需传入绝对路径与 id。
限制：只读，绝不修改、移动或删除会话文件；不做 superpowers 诊断，不命名缺陷或提出修改建议；归档与创建 issue 前必须获得用户批准；用户未回答前不开始分析；上下文安全需遵循 references/context-safety.md。