skills.rest
ZJUxjy
ZJUxjyCOMMUNITY
Explore all skills by this author →
GitHub

systematic-debugging

Guide software bug investigation through four structured debugging phases.

Updated Feb 27, 2026
Search Tags:#testing#debugging#troubleshooting#root cause analysis#bug fixing#software quality
One-click install
npx skills add https://github.com/ZJUxjy/opencode_lite --skill systematic-debugging-zjuxjy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ZJUxjy/opencode_lite/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/ZJUxjy/opencode_lite --skill systematic-debugging-zjuxjy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents time wasted on superficial fixes by enforcing a rigorous, multi-phase process to identify and address the root cause of any bug, test failure, or unexpected behavior.

Core Features & Use Cases

  • Structured Debugging: Guides users through four distinct phases: Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue rather than just patching symptoms.
  • Pressure Resistance: Includes rules and language designed to prevent shortcuts under time pressure or when a quick fix seems obvious.
  • Use Case: When a critical API endpoint starts failing intermittently, this Skill ensures a thorough investigation to find the underlying cause, preventing recurring issues and costly workarounds.

Quick Start

Use the systematic debugging skill to investigate any bug or test failure before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a software bug instead of just patching symptoms?▼

Systematic debugging prevents superficial symptom fixing by enforcing a structured four-phase process: investigation, pattern analysis, hypothesis testing, and implementation, ensuring you find and fix the fundamental issue.

What is the best way to troubleshoot an intermittent API failure?▼

Troubleshoot intermittent API failures by gathering detailed evidence and tracing data flows during an investigation phase before forming hypotheses. This ensures thorough investigation rather than quick, costly workarounds under pressure.

How do I stop taking shortcuts when debugging under time pressure?▼

To stop taking debugging shortcuts under time pressure, apply a systematic process with specific rules and pressure-resistant language. This enforces rigorous investigation and prevents jumping to obvious but incorrect fixes.

What should I do when multiple bug fixes fail to resolve a software failure?▼

When multiple bug fixes fail, you should escalate your debugging by performing architectural questioning and deeper data flow tracing. This helps uncover complex root causes that initial symptom-level fixes missed.

Does systematic debugging require any specific testing frameworks or dependencies?▼

Systematic debugging requires no specific testing frameworks or dependencies. It is a methodology guided through references and scripts that applies to any software bug, test failure, or unexpected behavior.

Related Skills

Explore More Software Engineering Skills→
ourskyoursky
30

debug

Reproduce software bugs, gather evidence, trace root causes, and apply minimal fixes.

Official
Advanced
sigitpoerwosigitpoerwo

core-debug

Reproduce, isolate, and root-cause bugs with verified fixes and regression tests.

Community
Intermediate
ArabelaTsoArabelaTso
142

reproduction-trace-instrumenter

Instrument Python programs to capture execution traces and generate JSON replay scripts.

Community
Intermediate
fakhriaditiarahmanfakhriaditiarahman
1

systematic-debugging

Diagnoses the root cause of technical issues through a four-phase systematic process.

Community
Advanced