Turn a Vague Bug Report into Evidence a Maintainer Can Rerun

Описание и применение

Преобразуйте расплывчатый отчёт об ошибке в воспроизводимый кейс, используя пять шагов: определите контракт, удалите лишнее, зафиксируйте минимальную среду, задайте агенту ограниченную задачу и упакуйте доказательства в короткую задачу для мейнтейнера.

Задача

Bug reports often lack reproducible details, making it hard for maintainers to verify and fix issues.

Результат

Bug reports are transformed into reproducible, concise issues that maintainers can quickly verify, reducing time to fix and improving collaboration.

Рабочий процесс

• 1. Write the failing contract: specify trigger, command, expected literal value, actual result, and failure frequency.
• 2. Remove unnecessary components: strip dependencies, UI, network calls, credentials, and setup steps, keeping only the failing condition.
• 3. Capture a minimal environment block: record runtime version, OS family, CPU architecture, package manager, and lockfile, omitting sensitive data.
• 4. Give a coding agent a bounded job: prompt the agent to run the command in the authorized checkout, report exact command, exit status, expected and actual values, and reproducibility, then stop.
• 5. Package the evidence: assemble a short issue with symptom, reproduction steps, expected/actual results, environment summary, frequency, negative control, link to minimal reproduction, and limits on observed data.

Доказательства

"It breaks sometimes on Windows" may describe a real defect, but it does not give a maintainer a testable starting point.

Источник

The useful transformation is small: turn the report into one trigger, one command, one literal expected result, and one captured actual result.

Источник

A complete issue can stay short: one-sentence symptom; exact reproduction steps; expected and actual results; environment summary; frequency and negative control; link to the smallest public reproduction; limits on what was observed.

Источник