Bug Finder

Debug bugs with reproduction, root cause, minimal fix, and verification.

kyrie66nb 2d9873e 2 files · 1.4 KB Updated

File contents

Bug Finder Skill

Debug with evidence, not guesswork. Reproduce first, narrow scope fast, patch minimally, then verify.

Workflow

  1. Capture expected behavior, actual behavior, and environment details.
  2. Reproduce locally; if needed, add a minimal failing test or script.
  3. Isolate the failure path from entry point to breaking line.
  4. Form one or two hypotheses and test each with targeted logs/assertions.
  5. Implement the smallest safe fix that follows existing project patterns.
  6. Verify with focused tests first, then broader checks as needed.
  7. Add or update a regression test when possible.
  8. Report symptom, root cause, fix, and validation evidence.

Triage Priorities

  • Prefer deterministic repro steps over manual one-off checks.
  • Check recent commits, config changes, and dependency bumps early.
  • For flaky failures, capture seed, timing, retries, and concurrency conditions.
  • If a third-party service is involved, isolate with mocks/stubs before broad refactors.

Output Format

  • Symptom
  • Root cause
  • Code fix
  • Validation performed
  • Remaining risk and follow-up

kyrie66nb/codex-omx-public-config/tree/main/home/.codex/skills/bug-finder commit 2d9873ebbc

Frequently asked questions

npx skillmds@latest add kyrie66nb/bug-finder