用途：当 superpowers 会话出问题（重复劳动、未遵循计划、卡顿、结果差、技能未触发等），且用户想知道原因时使用。
主要能力：通过结构化流程定位并报告问题。先做问题收集，逐一提问，直到能写出包含会话、轮次范围、预期、实际发生及关注指标（耗时、token、重复动作等）的陈述；再定位会话文件，用首个提示与时间戳确认过往会话，列出被排除的候选与原因，枚举子智能体记录，并在 ~/.superpowers/diagnosing-superpowers/<session-id>/ 下建立案件文件。随后并行派发多个分析子智能体，覆盖 skill-timeline、plan-adherence、repeated-work、stumbles、quality-evidence、request-conflicts、cost-and-time 七个维度，自行阅读问题区域，丢弃无 path:line 引用的发现。最后按模板填充报告并给出路径，可按需检索 GitHub issue、生成脱敏数据包或查找相似会话。
使用方式：按工作流创建 todo，逐步执行；步骤 5–7 仅在条件满足时运行。子智能体需传入绝对路径与 id。归档使用 zip -r 或 tar -czf，且须经批准。
限制：只读，禁止修改、移动或删除会话文件；不做 superpowers 诊断或提出改动建议；无 path:line 引用不成立；所有数字须来自记录或实际运行的命令；数据包仅在用户要求时构建，归档与创建 issue 前须经用户审批；用户不在时应写下问题并停止。上下文安全、人工提示仅限用户输入等规则须严格遵守，缺失信息暂未提供。