bugfix

Diagnose root causes, generate requirements, and execute verified one-shot bug fixes.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/sr-ai-dev/sr-harness --skill bugfix-sr-ai-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bugfix
Source: https://github.com/sr-ai-dev/sr-harness/tree/main/skills/bugfix
Command: npx skills add https://github.com/sr-ai-dev/sr-harness --skill bugfix-sr-ai-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The bugfix Skill removes guesswork from fixing failures by forcing a root-cause diagnosis first, then generating requirements and executing a verified one-shot fix.

Core Features & Use Cases

  • Root-cause-first bug fixing: performs debugger-style diagnosis and classifies the bug before any code changes.
  • Requirements-driven execution: converts diagnosis into a structured requirements.md and delegates the actual fix/verification to /execute.
  • Verification + safety guardrails: runs a standard verification pipeline, uses a max-attempt circuit breaker, and escalates with saved reports when repeated attempts fail.
  • Use Case: When you have an error log or failing test and you want a minimal, evidence-backed fix that avoids regressions.

Quick Start

Run bugfix by providing the error description you’re seeing, then choose whether to proceed with the generated root-cause fix or switch to full specification escalation if needed.

Frequently Asked Questions about bugfix

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

FAQPage Schema
How do I fix a failing test by finding the root cause instead of guessing?

To fix a failing test with root-cause certainty, this Skill performs a debugger-style diagnosis to classify the bug before any code changes, then generates structured requirements for a verified one-shot correction.

What is the best way to apply a minimal diff repair to a software bug?

The best way to apply a minimal diff repair is to enforce root-cause investigation first, convert the diagnosis into a requirements.md file, and delegate the actual code fix and verification to an execution pipeline.

How do I diagnose an error log to generate structured fix requirements?

You diagnose an error log by submitting the error description to trigger a root-cause-first analysis, which classifies the failure and outputs a structured requirements.md file to guide the verified correction.

What happens when repeated bug fix attempts fail to pass verification?

When repeated bug fix attempts fail verification, a max-attempt circuit breaker triggers escalation and saves debug reports, preventing infinite loops and preserving diagnostic data for manual review.

Can I use this approach to fix bugs from a stack trace without causing regressions?

Yes, you can fix bugs from a stack trace without regressions because the process enforces root-cause investigation first and executes a verified one-shot correction using a standard verification pipeline.

Do I need a full specification to start fixing a broken behavior?

You do not need a full specification to start; you can provide an error description to generate a root-cause fix, with the option to switch to full specification escalation if the initial diagnosis requires it.