skills.rest
Jason-chen-coder
Jason-chen-coderCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

dev-fix

Debug software bugs through structured hypothesis listing, instrumentation, verification, and targeted fixes.

5|Updated Apr 29, 2026
Search Tags:#root cause#verification#hypothesis testing#bug diagnosis#debug workflow#surgical fix
One-click install
npx skills add https://github.com/Jason-chen-coder/dev-skills --skill dev-fix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-fix
Source: https://github.com/Jason-chen-coder/dev-skills/tree/main/skills/dev-fix
Command: npx skills add https://github.com/Jason-chen-coder/dev-skills --skill dev-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the difficulty of reliably diagnosing the root cause of bugs and applying precise fixes without guesswork or unnecessary changes.

Core Features & Use Cases

  • Structured Debugging Workflow: Guides users through triage, hypothesis listing, instrumentation, and verification to locate root causes.
  • Root Cause Isolation: Enforces a surgical approach to fixing only the root issue, minimizing collateral changes and regressions.
  • Use Case: When a complex bug is reported, the skill helps systematically reproduce, hypothesize multiple causes, instrument code, verify fix effectiveness, and confirm the fix with full coverage.

Quick Start

Load the environment baseline, describe the symptom, reproduce with tests, list hypotheses, instrument code if needed, diagnose, fix the root cause, verify, and document the artifact.

Frequently Asked Questions about dev-fix

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

FAQPage Schema
How do I systematically find the root cause of a complex software bug?▼

Root cause diagnosis requires structured steps: reproduce the bug with tests, list multiple hypotheses, instrument code for verification, and isolate the exact issue. This hypothesis-driven approach prevents guesswork and ensures precise bug diagnosis.

What is the best way to apply surgical fixes without introducing regressions?▼

Surgical fixes target only the isolated root cause, minimizing collateral changes. Verify the fix effectiveness using regression tests with full coverage to confirm the issue is resolved without affecting other functionality in the debug workflow.

How do I create a debug workflow for low-confidence bug scenarios?▼

A debug workflow for low-confidence scenarios involves triage, listing hypotheses, and instrumenting code to gather data. Verify each hypothesis systematically before applying a targeted fix, ensuring accurate root cause isolation and documented RCA.

Does hypothesis-driven bug diagnosis work across multiple programming environments?▼

Hypothesis-driven bug diagnosis is applicable across multiple programming environments needing disciplined debugging workflows. It provides a structured methodology for triage, instrumentation, and verification regardless of the specific tech stack.

Why should I document RCA after fixing a software bug?▼

RCA documentation accompanies the verified fix to record the root cause, hypothesis testing process, and surgical fix applied. This ensures the debug workflow is traceable, prevents recurring issues, and provides regression test confirmation.

Related Skills

Explore More Software Engineering Skills→
huangzidahuangzida
2

diagnose

Diagnose hard bugs and performance regressions through a phase-driven reproduction-to-regression-test workflow.

Community
Advanced
lionbenjaminlionbenjamin
15

fix

Diagnose and fix codebase bugs with root-cause analysis and regression tests.

Community
Advanced
SuperlendSuperlend

coverage-analysis

Analyze code coverage from fuzzing campaigns and generate reports with LLVM tools.

Official
Intermediate
yumayoyumayo

diagnosis

Diagnose software defects by analyzing symptoms and investigating the codebase.

Community
Advanced