systematic-debugging

Guides a four-phase process to identify and fix root causes of software bugs.

134|12|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/6BNBN/FlowPilot --skill systematic-debugging-6bnbn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/6BNBN/FlowPilot/tree/main/%E5%85%BC%E5%AE%B9codex%40cursor%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E6%8A%80%E8%83%BD/codex%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E6%8A%80%E8%83%BD/.codex-home-claude-parity/skills/systematic-debugging
Command: npx skills add https://github.com/6BNBN/FlowPilot --skill systematic-debugging-6bnbn

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured, four-phase process to systematically identify and resolve the root cause of any bug, test failure, or unexpected behavior, preventing the common pitfalls of quick fixes and symptom treatment.

Core Features & Use Cases

  • Four-Phase Process: Guides users through Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue before applying any solution.
  • Anti-Rationalization: Includes explicit rules and red flags to prevent common excuses and shortcuts under pressure.
  • Use Case: When a test fails intermittently, instead of adding arbitrary timeouts, this Skill ensures you trace the issue back to its origin, implement a robust fix, and add preventative validation.

Quick Start

Use the systematic-debugging skill to investigate any bug or test failure you encounter.

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 how does it find the root cause of a bug?

Systematic debugging is a structured process that finds the root cause of a bug by prioritizing root cause analysis over symptom fixing. It guides you through investigation, pattern identification, hypothesis testing, and implementation.

How do I stop fixing symptoms and start finding the root cause of test failures?

To find the root cause of test failures, follow a four-phase debugging process: investigate the issue, analyze patterns, test hypotheses, and implement a robust fix. This prevents quick fixes and ensures you address the fundamental problem.

What is the best way to debug intermittent test failures without adding arbitrary timeouts?

The best way to debug intermittent test failures is to trace the issue back to its origin using a systematic process. Instead of adding arbitrary timeouts, identify the root cause, implement a robust fix, and add preventative validation.

How do I resist pressure to apply quick fixes during software troubleshooting?

To resist pressure during software troubleshooting, apply explicit anti-rationalization rules. These rules provide specific red flags to prevent common excuses and shortcuts, ensuring you complete the full systematic debugging process before applying a solution.

When should I use a systematic debugging process for bug fixing?

You should use a systematic debugging process when you encounter any bug, test failure, or unexpected behavior. It is essential when you need to prevent common pitfalls like quick fixes and symptom treatment by ensuring a thorough root cause analysis.