name: diagnosing-superpowers description: 当一次 superpowers 会话出了问题、你的人类伙伴想知道原因时使用——重复劳动、无视计划、磕磕绊绊、结果质量差、某个技能没触发、"太慢了"、"为什么这么贵"、"它到底在干什么"——或者想给 superpowers 维护者整理一份 bug 报告;适用于当前会话,或按 id / 路径指定的过往会话,任何工具均可 version: "1.0.0" license: MIT metadata: hermes: tags: [debugging, diagnosis]
诊断 Superpowers
概述
和你的人类伙伴一起明确一次会话到底哪里出了问题,读取磁盘上的会话记录(transcript), 用证据报告发生了什么。你负责报告,不负责诊断 superpowers。superpowers 要不要改, 由分诊这份打包材料或这条 issue 的人决定。
核心原则: 每条发现都要引用 path:line。没有引用,就不算发现。每个数字都来自
会话记录或你亲自跑过的命令,绝不凭记忆。
工作流
每一步建一个待办。第 5–7 步只在各自注明的条件下执行。
- 一次只问一个问题,直到你能写出一段陈述:点名是哪个(些)会话、 已知的话给出轮次范围、你的伙伴期望什么、实际发生了什么、他们关心的可观测量 (耗时、token、重复动作、某一个具体动作)。"太慢了"是抱怨,不是问题陈述。 记下目标是否是一份 superpowers bug 报告。