用途:当一次 Superpowers 会话出现重复劳动、无视计划、卡顿、结果质量差、某技能未触发、耗时长或成本高等情况时,和用户一起定位问题;也可为维护者整理 bug 报告。适用于当前会话,或按 id / 路径指定的过往会话。
核心原则:只报告证据,不诊断 Superpowers;每条发现必须引用 path:line,数字须来自会话记录或亲自运行的命令。只读,绝不修改、移动或删除会话文件。
工作流分步建待办:
- 问题受理:一次只问一个问题,直到能写出点名会话、期望、实际、可观测量的陈述;用户答复前不进入后续步骤。
- 定位:按 references/session-discovery.md 解析为核实的绝对路径,枚举子智能体会话,创建 ~/.superpowers/diagnosing-superpowers/<session-id>/,填写 templates/case.md。
- 分诊:先亲自读问题附近段落,再为每个维度并行派发分析员子智能体(skill-timeline、plan-adherence、repeated-work、stumbles、quality-evidence、request-conflicts、cost-and-time),无 path:line 的发现丢弃。
- 报告:按顺序填写 templates/report.md 并展示路径。
- GitHub issue:仅当报告 §7 为 possible/likely 或用户要求时,按 references/github-issues.md 搜索,批准后才创建。
- 导出:只在用户要求时打包,询问脱敏级别(skeleton / evidence / full),经 scrub 与 scrub-audit 直到 CLEAN,再经批准后归档(zip -r 或 tar -czf)。
- 相似会话:被要求时转成特征签名,并行分析后追加报告 §9。
限制:上下文安全须遵循 references/context-safety.md;子智能体需传绝对路径;只认人类提示词;不指出技能缺陷或提议修改;批准关卡前不归档、不发 issue;用户不在时写下问题后停止,不得替其重构陈述。具体收费、平台支持等信息暂未提供。