uv-systematic-debugging

Guide four-phase debugging through investigation, pattern analysis, hypothesis, and implementation.

1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/uv-xiao/pkbllm --skill uv-systematic-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv-systematic-debugging
Source: https://github.com/uv-xiao/pkbllm/tree/main/productivity/systematic-debugging
Command: npx skills add https://github.com/uv-xiao/pkbllm --skill uv-systematic-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured, step-by-step process to systematically debug any technical issue, ensuring root causes are identified and addressed, rather than just treating symptoms. It helps prevent recurring bugs and saves significant time by avoiding guesswork.

Core Features & Use Cases

  • Four-Phase Framework: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue before applying any fixes.
  • Pressure Resistance: Includes specific language and structural defenses against common rationalizations made under time pressure or urgency.
  • Use Case: When a critical bug appears in production, this skill ensures the team doesn't just apply a quick patch, but thoroughly investigates to prevent the bug from reappearing.

Quick Start

Use the uv-systematic-debugging skill when encountering any bug or unexpected behavior before proposing fixes.

Frequently Asked Questions about uv-systematic-debugging

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

FAQPage Schema
What is the best way to find the root cause of a bug instead of just treating symptoms?

Systematic debugging identifies root causes rather than symptoms by enforcing a rigorous four-phase framework of investigation, pattern analysis, hypothesis testing, and implementation to prevent recurring issues.

How do I debug production bugs systematically under time pressure?

Debugging production bugs under time pressure requires a structured framework with specific defenses against rationalizations, ensuring thorough evidence gathering and hypothesis testing before applying any quick patches.

How can I create a systematic process for troubleshooting test failures?

Troubleshooting test failures systematically involves moving through four distinct phases: investigating the failure, analyzing patterns, forming hypotheses, and implementing fixes based on collected evidence.

Does this systematic debugging framework work for performance problems and error handling?

This debugging framework applies to all software development scenarios, including performance problems and error handling, by enforcing root cause analysis to ensure robust solutions.

Why should I use a systematic debugging framework before proposing fixes?

Using a systematic debugging framework before proposing fixes prevents recurring bugs and saves significant time by avoiding guesswork, ensuring the fundamental issue is addressed thoroughly.

What are the limitations of using a systematic debugging process for urgent bug fixing?

While systematic debugging prevents recurring issues, its rigorous investigation and evidence gathering requirements may conflict with extreme time pressures, requiring specific structural defenses against rushing quick patches.