bug-triage
Installation
SKILL.md
Bug triage
Establish scope
- Read repository instructions and inspect the current branch, status, and relevant diff.
- Determine whether the user asked only for diagnosis or also authorized a fix.
- Inspect available errors, logs, tests, and code before asking for missing details.
- Record expected behavior, actual behavior, environment, frequency, and last known good state when they affect the investigation.
Reproduce and isolate
- Use the smallest reliable reproduction. Preserve the original failure output.
- If the failure is intermittent, control time, randomness, concurrency, data, and retries one variable at a time.
- Trace the failing path end to end. Search every caller of the function or component before editing it.
- Form a falsifiable hypothesis and run the narrowest check that can confirm or reject it.
- Use history or
git bisectonly when a regression boundary will materially shorten the search.
Separate these outcomes explicitly: