diagnosing-superpowers

1# 诊断 Superpowers
2 
3## 概述
4 
5和你的人类伙伴一起明确一次会话到底哪里出了问题，读取磁盘上的会话记录（transcript），
6用证据报告发生了什么。你负责报告，不负责诊断 superpowers。superpowers 要不要改，
7由分诊这份打包材料或这条 issue 的人决定。
8 
9**核心原则：** 每条发现都要引用 `path:line`。没有引用，就不算发现。每个数字都来自
10会话记录或你亲自跑过的命令，绝不凭记忆。
11 
12## 工作流
13 
14每一步建一个待办。第 5–7 步只在各自注明的条件下执行。
15 
161. **问题受理。** 一次只问一个问题，直到你能写出一段陈述：点名是哪个（些）会话、
17   已知的话给出轮次范围、你的伙伴期望什么、实际发生了什么、他们关心的可观测量
18   （耗时、token、重复动作、某一个具体动作）。"太慢了"是抱怨，不是问题陈述。
19   记下目标是否是一份 superpowers bug 报告。
202. **定位。** 按 `references/session-discovery.md` 把每个会话解析成经过核实的
21   绝对文件系统路径。确认过往会话时，引用它的第一条提示词和时间戳，并列出你排除的
22   每个候选及理由，没有就写"none"。枚举子智能体的会话记录。创建
23   `~/.superpowers/diagnosing-superpowers/<session-id>/`，把路径告诉你的伙伴，
24   在其中填写 `templates/case.md`，环境与技能观察遵循其中的来源标注规则。
253. **分诊。** 先亲自读报告问题附近的那一段。然后为每个维度并行派发一个分析员子智能体，
26   每个都给它：案例文件路径、`prompts/analyst-common.md`，以及 `prompts/` 下的一个
27   维度文件：`skill-timeline.md`、
28   `plan-adherence.md`、`repeated-work.md`、`stumbles.md`、
29   `quality-evidence.md`、`request-conflicts.md`、`cost-and-time.md`。
30   会话记录很长时，按轮次范围拆分一个维度。凡是返回的发现没有 `path:line`，一律丢弃。
314. **报告。** 按顺序填写 `templates/report.md` 的每一节，写入工作区，展示出来，
32   并给出路径。核对被引用的内容实际能证明什么，并保留支撑它的案例；符号链接别名
33   不算冗余副本。
345. **GitHub issue** —— 当报告 §7 写的是 possible 或 likely，或你的伙伴要求时。
35   按 `references/github-issues.md` 在已开放和已关闭的 issue 中搜索这些症状。
36   展示匹配结果，建议把报告补充到最接近的那条。如果都不匹配，填写
37   `templates/issue.md`，写入工作区，展示确切文本，获得批准后才创建 issue。
38   `gh` 不能附加文件；如果有打包材料，把路径给你的伙伴，让他们在浏览器里附上。
396. **导出** —— 只在你的伙伴要求打包时进行；绝不主动打包。如果受理时的目标是 bug
40   报告，说一次"可以按需提供脱敏后的打包材料"，然后等待。询问脱敏级别，并说明每一级
41…