systematic-debugging

Guide structured four-phase debugging with root cause analysis and hypothesis formation.

Updated Oct 21, 2022
One-click install
npx skills add https://github.com/Chengxufeng1994/dotfiles --skill systematic-debugging-chengxufeng1994
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Chengxufeng1994/dotfiles/tree/main/gemini/antigravity/global_skills/systematic-debugging
Command: npx skills add https://github.com/Chengxufeng1994/dotfiles --skill systematic-debugging-chengxufeng1994

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents wasted time and new bugs by ensuring that the root cause of any issue is identified and addressed before any fixes are implemented. It combats the tendency to fix symptoms or apply quick patches that mask underlying problems.

Core Features & Use Cases

  • Systematic Four-Phase Process: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue, not just addressing surface-level symptoms.
  • Pressure Resistance: Includes specific language and structural defenses to prevent shortcuts under time pressure or when a quick fix seems obvious.
  • Use Case: When a test fails unexpectedly, instead of guessing or applying a temporary workaround, use this Skill to methodically trace the error, identify the exact point of failure, and implement a permanent solution.

Quick Start

Use the systematic debugging skill to investigate any bug or unexpected behavior before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when should I use it?

Systematic debugging is a structured process to find and fix root causes instead of symptoms. Use it when a test fails unexpectedly or when you need to trace an error methodically rather than guessing or applying temporary workarounds.

How do I find the root cause of a bug instead of just fixing symptoms?

To find the root cause, follow a four-phase process: Investigation, Pattern Analysis, Hypothesis, and Implementation. This ensures you identify the fundamental issue and implement a permanent solution before applying any fixes.

What is the best way to troubleshoot software issues under tight deadlines?

The best way to troubleshoot under pressure is using a structured debugging process with built-in pressure resistance. It provides specific rules and anti-patterns to prevent shortcuts and quick patches that mask underlying problems.

How do I prevent introducing new bugs when fixing an unexpected error?

Prevent new bugs by mandating root cause analysis before implementing any fixes. This structured approach ensures you trace the exact point of failure and apply a permanent solution, avoiding quick patches that create new issues.

What are common debugging anti-patterns to avoid during error analysis?

Common debugging anti-patterns include fixing symptoms instead of root causes and applying quick patches under time pressure. Resist these pitfalls by following a structured investigation, pattern analysis, and hypothesis process.