reversa-debugger-fix

Diagnoses and fixes registered bugs through gated reproduction, root-cause analysis, and regression tests.

Updated May 22, 2026
One-click install
npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill reversa-debugger-fix-gleisonoliveira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-debugger-fix
Source: https://github.com/GleisonOliveira/dockerpilot-mcp/tree/main/.agents/skills/reversa-debugger-fix
Command: npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill reversa-debugger-fix-gleisonoliveira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It takes a bug already registered in the Reversa bug registry and drives it to a verified, auditable closure: reproduction with evidence, root-cause tracking, approved change sets, regression tests, and a spec verdict, instead of ad-hoc untracked fixes. ## Core Features & Use Cases - Guided fix lifecycle: reproduction capsule, epistemological root-cause states (hypothesized/supported/confirmed), optional git bisect regression analysis, and impact-based bug selection across contexts. - Two approval gates: test diffs must be approved and shown failing before the correction change set is approved and shown passing, with all diffs saved under fix/. - Spec verdict and closure policy: compares the fix against the effective spec, generates versioned addenda when needed, and locks the bug folder with a DONE.md marker once the closure policy is satisfied. - Use Case: After registering a checkout bug with /reversa-debugger, run this skill to reproduce it, write failing regression tests, apply a minimal approved patch, and close the bug with full traceability. ## Quick Start Ask the agent to fix a registered bug by running /reversa-debugger-fix with the bug ID, for example: fix BUG-20260715-A7K3 following the Reversa workflow.

Frequently Asked Questions about reversa-debugger-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a registered bug with reversa-debugger-fix?▼

Invoke /reversa-debugger-fix with a bug ID or display number, such as /reversa-debugger-fix BUG-20260715-A7K3. Without an argument, it computes an impact score across open bugs and suggests the highest-impact one for you to choose.

What is required before running this bug fixing skill?▼

The bug must already be registered via /reversa-debugger, creating the _reversa_bugs directory with the bug record. If that registry does not exist, the skill aborts and tells you to register the bug first.

Does the skill modify project files without approval?▼

No. Reading, reproduction, and diagnosis run freely, but every change to the project passes through approval gates with diffs shown first. Test changes are approved at Gate 1 and the correction change set at Gate 2.

What happens when a bug cannot be reproduced?▼

The skill never invents a cause. It offers to close the bug as instrumentation-required, where the change set adds logging, metrics, or tracing to capture the next occurrence, treating instrumentation as a valid resolution.

Can a closed bug be reopened or modified?▼

A bug with a DONE.md lock is read-only and the skill refuses to modify it. Reopening requires the user to manually remove the lock, or to register a new bug with a regression-of relation pointing to the locked one.