Skip to content

pillumina/ascend-sleuth / skills/diagnose

diagnose

Verified

昇腾训练/推理问题的核心诊断循环:收集症状、按 triage-tree 路由、两阶段加载 并验证 Tier 2 case、命中给 fix(高危 root cause 改提示 halt)或转深度排查。 Tier-2 未命中但最终解决时起草候选 case。全程写 trace。 仅在能执行命令的 agent(Claude Code / Codex / pi)中可用。

references/report-template.md

View on GitHub
# 诊断定位报告(人读件)——结构与行文规范

> **本文是 diagnose 产出面的契约之一**,与 trace(过程轨迹)、对话输出(现场答复)并列。
> 报告写给**人**看:让读者能在不重读 trace 的前提下复述结论、核对证据、自己判断对错,并从中学到机制。
> 读者画像决定规格:报告**一律按深度排查写**,不设"短版报告"。

## 1. 三份产出各管什么(先分清,避免互相抄)

| 产出 | 位置 | 读者 | 管什么 | 不管什么 |
|---|---|---|---|---|
| **对话输出** | 会话里 | 现场工程师(当下) | 立刻能行动的答复:结论 + 依据 + fix + 可靠度 | 不追求完整;关掉会话即散 |
| **trace** | `traces/<session_id>.yaml` | agent / 面板 / 回放 | 过程可回放:每步动作、决策依据、证据落盘、沉淀候选(机器可读) | 不适合人从头读到尾 |
| **定位报告** | `traces/<session_id>.report.md` | 人(复盘 / 评审 / 交接 / 学习) | 完整逻辑链:现象 → **日志定位过程** → 证据 → 源码 → 机制 → 修复 → 下一步 → 可沉淀什么 | 不替代 trace;不替代 postmortem(知识草稿的入口仍是 to-postmortem) |

三者内容允许**结论一致**,但**不互为副本**:报告不抄 trace 的逐条交互,trace 不为报告而膨胀。

## 2. 产出与维护:报告是**活件**,不是一次性的交付物

诊断会继续(用户回报结果、resume 续接、新证据到达、结论被推翻、沉淀动作发生),报告必须**跟着长**——
否则它会在第一次交付后开始说谎,比没有报告更糟。规则三条:

- **同一份文件改到底**:始终是 `traces/<session_id>.report.md`,不另起 `report-v2.md`。读者手上永远只有一份。
- **修订留痕,不静默改写历史**:每次修订在元信息里更新"最后更新",并在「修订记录」追加一行
  `- <日期> 依据 <来源>(回报/resume/新证据):改了什么`。旧结论被推翻时**不要删掉旧结论**——
  降级标注("初判 X,因 Y 已推翻")并写清分歧,读者要看得到判断是怎么变的。
- **同步两侧**:报告第 8 节与 trace 的 `sediment_candidates` 同源,改一侧必改另一侧;每次修订往 trace 追一条
  `{action: report, ...}`(续接时 step 递增),让"报告被维护过"这件事可观测。

各触发点改哪几节:

| 触发 | 改哪几节 | 特别要求 |
|---|---|---|
| 首次产出(诊断步骤 6) | 全部 | 即使命中已知 case 也要写清机制(见下条"深度") |
| 用户回报 fix 结果(解决/没解决/部分) | 1(可信度行)、6(生效验证的实际结果)、7(待回报 → 已回报)、8(候选状态) | 把"回报原话的要点"写进 7 或附录时间线;没解决要写明分歧与下一步 |
| `resume-diagnosis` 续接 | 7(当前状态与下一步)、3(新证据并入 3.1 的过程与对应强度段)、必要时 4/5、修订记录 | 不许重写整份(保留原有依据链,只增补) |
| 新证据推翻原结论 | 1、3、7、修订记录 | 留痕(见上一条),并在 3 里标注"该结论已由 <证据> 推翻";trace 的现场侧 / 日志过程 / 上游查证三段(`incident_timeline` / `failure_process` / `upstream_timeline`)的当前值同步改——走 `scripts/trace_transition.py --field content` 写入口,自动落一条 `revisions`,不手改 YAML |
| 沉淀动作发生(to-postmortem / to-reference) | 8(`proposed` → `drafted` → 已沉淀 case id) | 同步 trace 的 `sedimented` 与 `sediment_candidates[].status` |
| 报告已闭环(问题解决或转上游) | 0(状态)、7(收尾)、修订记录 | 状态词与 `trace-status.yaml` 一致 |

- **深度**:固定按深度排查规格——**即使根因已由命中 case 确定**,也要写清"为什么是这个根因"(机制、判定顺序、可核对锚点)。
  理由:读者的目的是**判断与学习**,不是接受一个结论。
- **不做的事**:无源码分析时**不删**第 4、5 节,如实写"本轮未做源码分析 + 原因(无源码/无网络/属配置层)"。结构可比内容完整更重要。

## 3. 结构契约

必需的节(缺哪个都算不合格):

| 节 | 内容 | 写法要点 |
|---|---|---|
| 0 元信息 | session id、问题来源(issue/工单/现场)、诊断日期、**最后更新**、环境四件套(框架·CANN/驱动·平台·部署形态)、状态、severity | 报告被单独转发时,靠这一节自证出处与前提;"最后更新"让读者知道这份是初判还是已闭环 |
| 1 **TL;DR** | 现象 / 根因 / 该动哪个开关,三行内;末尾一行写"可信度 + 前提" | 不含内部词表;读者只读这一段也能决策 |
| 2 背景与现场材料 | 现象、复现条件、影响面、已提供材料清单、**缺什么材料** | 让读者判断"结论是否被现场条件限死" |
| 3 依据链 | 分四段,第一段是 **3.1 日志定位过程**(本轮一步步查了哪几层日志:每步带可复制命令、命中或未命中、据此下一步;写法见 3c),其后是 `已验证`(本轮实际查到)/`推测`(依赖推断)/`数据`(历史积累);命中 case 或候选排除链写在这里 | 每条结论后面都能指到一条证据。**有原件的引文按回验结果标**:核过才写"已验证";核不过(不一致 / 找不到 / 行号越界)降级为推测并写明原因;无原件的引文照旧,不因"没核"再降一级 |
| 4 源码分析 | 仓库 + ref(tag/commit)+ 文件:行 + 关键片段 + 由此得出的因果链;附可复现命令 | 这是"可复核"的落点,也是知识库只留代码指针的地方 |
| 5 机制图 | mermaid(1–3 张)+ 图注(这张图讲什么、按什么顺序读) | 形态与配色见第 5 节;图不承担正文没说过的信息 |
| 6 修复方案 | 第 0 步核验(前提未验证时先核验)→ 分支动作 → `rollback` / `side_effects` → 如何验证生效 | 具体到命令或 diff 要点 |
| 7 当前状态与下一步 | 停在哪一步、待回报什么、feedback 债、**未验证的假设清单** | 这一节为 resume 服务:只读报告即可接上现场 |
| 8 沉淀建议 | 结构化条目:`类型`(case / reference / triage)/ 一句话内容 / 证据出处 / 建议 skill | 与 trace 的 `sediment_candidates` **同源**,不写两套 |
| 9 附录 | 9.1 **现场时间线**(只放可观察事实,与 trace 的 `incident_timeline` / `failure_process` 同源);9.2 **上游与查证**(issue / PR / 维护者答复 / 落地实证结论,与 `upstream_timeline` 同源);9.3 命令清单;9.4 环境备注(影响后续复核的环境事实);外部链接 | 跨轮排查时时间先后本身是判据:现场段一条一个事实、按发生顺序,时间精度照材料;上游段只放查到的证据与查证结论,推断标成推断;命令清单只放一次性、可整段复制的命令(逐步查询命令留在 3.1) |
| 10 修订记录 | 每次修订一行:日期 + 依据来源 + 改了什么 | 报告是 gitignored 的本地件,没有 VCS 历史——**它得自己带变更记录**。初版写一行"初稿";结论被推翻的那一行写进 trace 的 `revisions` 类别(`kind`)与 before → after,读者不必回 trace 对 |

## 3b. 质量基线(对标已通过人审的样本)

"结构齐全"只是及格线。下面这些是**被读者认可的那份报告**实际做到的,逐条对照:

机械项(`report_lint.py` 能钉):

- 第 0 节含"最后更新";第 9、10 节非空;其余必需节非空且达到各自的最小篇幅
- 机制图每个代码块成对闭合、带 `classDef` 语义配色
- 报告点名的 `traces/` 路径真实存在
- 报告有第 8 节 ⇔ trace 有 `sediment_candidates`(双向)

人审项(判断,不做硬门):

- **TL;DR 自足**:只读它就能决策"改什么地方";它给的是判断,不是目录
- **有排除链**:不只说"是什么",还说"为什么不是别的"(候选逐条给排除理由与版本匹配)
- **源码分析是可复核的**:仓库 + ref + 文件:行 + 片段 + 可复现命令,任何人能重跑一遍得出同样结论
- **机制图讲因果不讲清单**:至少一张图承担"为什么会这样"(现象链或判定顺序),并配一句读图顺序
- **修复方案带前置核验**:前提没验证时第 0 步是核验,不是直接开方
- **未验证的写"未验证"**:假设清单显式列出,不许把"看起来像"写成"是"
- **读者能据此学到东西**:机制、判定顺序、为什么这句报错会误导人——这些是报告存在的理由
- **日志定位过程能重跑**:3.1 每步都带可复制命令,读者照着跑能得到同样的命中与未命中
- **未命中不堆行**:3.1 里标了未命中的条数不超过命中的条数,且每条都写了它改变了什么(判据与写法见 3c)

## 3c. 日志定位过程(第 3 节的第一子节)

**为什么它排在最前**:结论只回答"是什么",维护工程师缺的是"凭什么想到去看那一层"。这段过程换个案子还成立,是方法论(`references/methodologies/`)的原料;缺了它,报告只能被接受,不能被复核,也不能被学走。

**形状:一步一块**。不要用表格——命令一进表格就把列撑爆。每块四件:

1. **层与目的**:`**步 N · <哪一层日志>(<文件或目录>)**——<这一步要定什么>`
2. **命令**:可复制的一行或一小段
3. **命中**:查到什么,写证据原值(报错原文、`文件:行`、返回码)
4. **据此下一步**:这条结果把方向推到哪

三条硬要求:

- **每步都有可复制命令**。写"查了 plog"不算——读者要能重跑一遍得到同样结果;提炼方法论时,这条命令直接就是流程词条的 `check` 字段。
- **未命中只在改变了下一步时写**。写法是命令后紧跟 `**未命中**`,写明它排除了什么、于是转向哪。判据是"这条'查了没有'有没有改变你的下一步动作"——改变了就写(这是最值钱的一段),顺手试空、方向没变就不写。
- **不设"未命中清单"**。未命中挂在它导致的那一步里,与动作绑定;单列一节必然退化成流水账。

**走不通的路单独写一句"边界"**:材料里没有可查的键(plog 只给到首报错段、该日志层不含这个字段)时,写一行说明这条路为什么走不通。它不是未命中——不是搜了没搜到,是没得搜——标明这一点,下一个人不必重复试。

**本轮没有日志材料时**(问题只从 issue 正文或口头描述来):3.1 写一行"本轮无日志材料(原因)"就过,与第 4、5 节的"不做的事"同一条纪律——结构在,内容如实,不编一段过程出来。

**别与另外三处重复**:

- **9.3 命令清单**只放一次性、可整段复制的命令(转码、导出、拉源码);逐步的查询命令留在 3.1 里带着因果,不抄第二份。
- **trace 同源**:改变结论的那几步同步记 trace(`run_check` 的 `check` / `verdict` / `evidence`,或 agent 事件的 `reason`);3.1 是它的可读呈现,不为报告另起一套记录。
- **环境事实**(日志编码、噪音来源、返回码进制)写 9.4 环境备注;3.1 里只出现与这一步直接相关的那一条(如"UTF-16LE,先 iconv")。

**示例**(命令是真实形态,日志层与检索键按现场换):

**步 1 · 打屏日志** `worker_<rank>.log`——定失败进程与 device。日志是 UTF-16LE,直接 grep 报 `Illegal byte sequence`,先转码。

```bash
iconv -f UTF-16LE -t UTF-8 worker_<rank>.log > /tmp/worker.utf8.log
grep -nE "stopping device|Start training loop|rank id" /tmp/worker.utf8.log | tail -20
```

命中 `Pynative training failed, stopping device 5` → 缩到本地 device 5,进 plog 查首报错。

**步 2 · plog**——定失败操作是哪一步。

```bash
grep -nE "halSqCqAllocate|drvDevId=5" plog-*.log
```

命中 `halSqCqAllocate failed, drvRetCode=-1, drvDevId=5, tsId=0` → 失败操作是给 coprocessor stream 申请并绑定 logic CQ,不是通信本身。

**步 3 · plog 找否定证据**——排除"预算被占满"。

```bash
grep -nE "EE1023|Failed to alloc stream id|no stream resource" plog-*.log
```

**未命中** → 预算类失败必打 `EE1023`,没打就不是预算问题 → 停止沿资源方向查,转内核日志。

**步 4 · 内核日志** `message.log`——按失败时间窗取原始记录,先滤掉心跳噪音。

```bash
awk '/^Sep 14 17:1[1234]:/' /tmp/message.utf8.log | grep -v ctactvd | grep -E "\[ascend\]" | grep -E "ERROR"
```

命中 `devdrv_sync_non_trans_status_handle ... dev_id=5 ... common_msg_esched ... no resp ... ret=-38` → 判"设备侧调度器不应答"(返回码语义见 4.2)。

## 4. 行文规范

本节是写作时照着执行的完整集(skill 自包含:没有 `docs/` 也能照此写);逐条与源条目一一对应,省略的只有"本仓现状"一类描述。完整条目、判定口径与各面差异见
`docs/spec/writing-norms.md`(**可选论证层**——写报告只需要本节)。

逐条对照(条目与编号同 `docs/spec/writing-norms.md` 的共用条目,避免两处对不上):

1. 一条只说一件事,超一个分句就拆行。
2. 主语用具体对象、谓语用动词;抽象名词当主语就重写("验证措辞来自文档 PR"→"指南里那句『已按此拓扑验证』出自只改文档的 PR")。
3. 自造代称首次出现即定义:为本次诊断临时起的简称(给某个中间状态起的别名)只有写的人看得懂。
4. 不用比喻与拟人。
5. 不用对偶与排比(否定式排比"这不仅仅是 A,而是 B"也算);例外:诊断里的排除是事实内容,"根因在 B,不在 A"允许,但要紧跟证据。
6. 不用强调副词("唯一""恰好")。
7. 引号不做强调;「」只用于引用字段名、控件名或原话(完整分工见第 42 条)。
8. 不自我评价("如实记录""不冒充"删掉:如实是默认要求,不必声明)。
9. 不凑数:手上有两条就写两条。
10. 同一个东西从头到尾用同一个词,不换同义词。
11. 归因写具体出处(issue 链接、维护者原话、`文件:行号`),不写"有观点认为"。
12. 删填充与过度限定("值得注意的是数据显示"→"数据显示";"可能潜在地"→"可能")。
13. 不用通用积极结论收尾("后续将持续优化"→ 删掉,或写成具体的下一步)。
14. 术语优先于修辞,能当判据名引用。
15. 粗体只给读者要执行的东西(开关名、命令、阈值、结论)。
16. 不写裸 Markdown 星号。
17. 不用空泛大词("此外""至关重要""深入探讨""赋能""格局"换成具体动词,或删)。
18. 不绕开"是"字("作为/代表着/充当一个"→ 直接说"是")。
19. 不滥用破折号(改逗号或句号;一段里多个就值得重写)。
20. 不写虚假范围("从 X 到 Y" 只在真同一尺度时用)。
21. 不写内联标题垂直列表(连续多段"**小标题**:正文"改成小标题或自然段)。
22. 节奏要有变化:句长与段落收尾换着来,避免连续同构句式。
23. 面向人的正文不直接称呼读者,用无主句或角色名(如"开发者""维护者""实施人员");对 agent 下指令的 `skills/**` 与手把手带操作者的帮助文本(`docs/guide/`、`docs/README.md`、`docs/demo-walkthrough.md`)保留"你"。
24. 一句只说一个动作(用"并""然后""同时"连接两个动作就拆句)。
25. 句子分档控长:指令句不超过 25 字,说明句不超过 40 字(机检阈值放到 100 字)。
26. 不写"进行 / 作出 / 加以 / 予以 + 名词"("对日志进行分析"→"分析日志")。
27. 主动语态;施事未知、或只关心结果时才用"被"。
28. 不写套话("需要注意的是""在一定程度上""某种意义上""不难看出""众所周知")。
29. 情态照抄:"可能 / 也许 / 多数情况"不得升格成"会 / 必然"。
30. 不写双重否定。
31. 并列项、步骤或条件到三条就改列表;列表项彼此平行,编号项以动词开头。
32. 中文与英文、数字之间加一个半角空格("在 Windows 上跑 3 次"),全角标点前后不加。
33. 数字与中文之间保留那个空格;数字与半角单位符号之间也加一个半角空格(`10 GB`、`200 ms`、`25 °C`);百分号与角度符号紧贴数字(`50%`、`90°`),温度单位 `°C` 与角度符号 `°` 是两回事;不写"降低 N 倍",改用百分比或绝对量。
34. 省略号写"……",不与"等"连用,也不用三个点。
35. 破折号写全角"——",不用单个"—",也不用两个半角连字符。
36. 中文正文的括号写全角(),内侧不留空格;作品名写书名号《》,不用「」(控件与字段展示名的引号分工见第 42 条);代码与英文原文里的括号保持原样。
37. 并列项之间用顿号,末项前不加"和 / 及"。
38. 四位数以上的量加千分位;编号、版本号、字段值不加。
39. 缩写首次出现给全称;专有名词保留原始大小写(vLLM、PyTorch)。
40. 不写管理黑话动词(无缝对接、赋能、闭环、抓手、拉通、对齐)。
41. 文件名用小写 ASCII 与连字符分词(`doc-standards.md`)。
42. 引号分工:引述他人写法与短语用 ASCII 直引号;字段名、控件名、原话与规则名用「」;全角弯引号不用。
43. 确定写错的词照固定对照表改(阀值→阈值、布署→部署、反回→返回、回朔→回溯、做为→作为、embeding→embedding、提示工程学→提示工程);表外的近音词与易混词按语境判,不做机械替换(登录系统 / 登陆月球、配置参数 / 配制溶液、截至 4 月 12 日 / 截止日期、启用功能 / 起用新人、认证 / 授权)。

**必须保留原值、不翻译的四类**:字段名与枚举、仓库路径与命令、已成术语的比喻、**证据原值**(编号、`文件:行号`、
命令、数字、报错原文)——读者要拿它去复核,通俗化即失去可核查性。

报告特有的三条:

- **结论可核对**:每个结论都指回一条证据(`文件:行`、命令输出、issue 链接)。指不回去的,标成推测。
- **诚实退化**:没验证就写"未验证"并写清怎么验证;不许把"看起来像"写成"是"。
- **篇幅服务读者**:推荐 150–500 行。超过 500 行先自查是否把 trace 抄了一遍。短于 100 行的"深度报告"通常意味着某节在敷衍。

## 5. mermaid 规范(现代、精致、可读)

直接给 mermaid 代码块(` ```mermaid `),不要贴图片。约定:

- **图型选对**:现象→根因链用 `flowchart LR`;判定/分流顺序用 `flowchart TD`;时序(谁先谁后、谁发了什么)用 `sequenceDiagram`。
- **节点文案 ≤ 12 字**,长解释放正文;节点里不要塞句子。
- **配色按语义**,别用默认灰:
  ```
  classDef prob  fill:#FEE2E2,stroke:#DC2626,color:#7F1D1D
  classDef evid  fill:#E0F2FE,stroke:#0284C7,color:#075985
  classDef concl fill:#DCFCE7,stroke:#16A34A,color:#14532D
  classDef mute  fill:#F1F5F9,stroke:#94A3B8,color:#334155
  ```
  语义固定:`prob` 现象/故障、`evid` 证据/检查、`concl` 结论/动作、`mute` 背景。
- **主因链要看得见**:关键那条边用 `==>` 或 `linkStyle` 加粗上色,别让读者自己找。
- **规模**:单图 ≤ 15 个节点,超了拆图。三类图各司其职,按现场有什么选:
  **现象链**(`flowchart LR`:从一次调用走到那句报错,回答"怎么发生的")、
  **判定顺序**(`flowchart TD`:解析/检查按什么顺序走、在哪一步落空,回答"为什么这句报错会误导人")、
  **判别-修复分支**(`flowchart TD`:核验输出 → 分支 → 对应动作,与第 6 节的第 0 步一一对应)。
  有源码分析就要有前两类中的至少一类;修复方案有分支就要有第三类。
- **每张图配一句图注**写"这张图讲什么、按什么顺序读"。
- **不装饰**:不用 emoji;标签里有 `()`、`:`、`/` 时用引号包住,避免语法错。

## 6. 沉淀建议怎么写成结构(与 trace 同源)

报告第 8 节与 trace 的 `sediment_candidates` 是**同一份内容**的两种呈现:报告给人读,trace 给机器与 resume 读。一条候选写四件事:

```yaml
sediment_candidates:
  - kind: reference          # case | reference | triage
    summary: 一句话说清可复用的结构事实(跨事故稳定,不绑定本次个案)
    evidence: 本轮的哪条证据支撑它(trace 事件 / 文件 / issue)
    suggested_skill: to-reference   # to-postmortem | to-reference | knowledge-groom
    status: drafted          # drafted(本轮已起草)| proposed(建议做,未做)| produced(已产出)
    ref_id: <ref-id>         # 仅 produced:产出词条的 id,由 to-reference 回写
```

报告第 8 节写落报告时的状态(drafted / proposed);to-reference 产出后只回写 trace 里那条候选为 `produced`,报告不必追改这一格——两边以 trace 为准。

判断"值不值得沉淀 reference"的口径:**换个事故、换个客户还成立吗**?只对本次个案成立的,不要写成 reference;那是 case 的活儿(走 to-postmortem)。

**候选要克制**(实测反馈:一次诊断抛出 3 条候选,读者第一反应是"为啥是 3 条"——数字本身不可判断,候选成了噪音):

- 默认只有一条:本案的 case(走 to-postmortem)。
- reference 候选只在"跨事故稳定"**且**"本轮有独立证据"时才写;一次最多两条,每条要能一句话说清它**独立于本案**的理由。把官方文档里的支持矩阵/版本表抄一遍不算独立证据。
- 诊断途中顺手读到的平台/版本事实(文档里查到的支持面之类)算**观察**,写进附录,不占候选名额。
- 候选超过两条时,第 8 节要为每条补一句"为什么它值得单独沉淀"——写不出就说明它在凑数。

## 7. 交付前自检

机械项(`python scripts/report_lint.py traces/<session>.report.md`,本仓库脚本;**刻意不进 CI**——报告是判断性产出,硬门会逼出套话):

- 必需节齐全且非空(0–8 节 + 第 9、10 节)
- 元信息含"最后更新"(读者要知道这是初判还是已闭环)
- TL;DR 不超过 3 行正文
- mermaid 代码块成对闭合,且带至少一个 `classDef`
- 报告点名的证据文件在仓库里真的存在
- 报告有第 8 节时,trace 必须有 `sediment_candidates`(不写两套)
- **有原件的引文核过**:`python scripts/verify_evidence.py traces/<session>.yaml --root <原件根>`(同一脚本家族,同样不进 CI)——它逐条重读原件比对,退出非零表示至少一条引文不能用;报告里对应的结论已按第 3 节降级。没有原件的单子这条为空(无原件可核不是问题)

修订时另加三条(详见第 2 节):

- 第 10 节追加了一行(日期 + 依据来源 + 改了什么),且旧结论没有被静默删除
- 改动涉及第 8 节时,trace 的 `sediment_candidates` / `sedimented` 已同步
- trace 追了一条 `{action: report, ...}`(让"报告被维护过"可观测)

人审项(判断性,不做硬门):

- 一个不了解本问题的工程师,只读报告能否说出"哪里坏了、为什么、下一步动什么"?
- 每个结论是否都能指到证据?推测是否显式标了推测?
- 有没有为了显得完整而凑数(三段式、通用积极结论、抄 trace)?
- 3.1 的每一步能不能原样重跑?标了未命中的那几步是否都改变了方向,而不是顺手试空?
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall