Bug Root Cause Fix Copilot
Paste the following prompt into your AI chat to install this skill:
Follow https://skillhub.cn/install/skillhub.md to install @user_ffcaaae9/bugfix-root-cause-copilot.
About this skill
Problem It Addresses
When a stack trace, failed test, regression, or functional anomaly appears, the bottleneck is often not visibility but fragmented evidence, over-speculation, and overly broad fixes. This skill constrains debugging into an executable path: confirm reproduction boundaries, identify a root cause with evidence, then land a minimal change and verification checklist, reducing the risk of creating another regression.
How It Works
- Inputs: uses error messages, reproduction steps, relevant code paths, and constraints; if critical context is missing, asks at most three focused questions before proceeding with reasonable assumptions.
- Diagnosis: prioritizes high-probability causes such as null values, types, boundaries, state synchronization, timing, and configuration, and requires an evidence chain instead of a generic list of possibilities.
- Fix scope: prefers the smallest viable change, identifies affected files or logic, explains why impact should not expand, and notes rollback needs when relevant.
- Verification: produces manual test steps and the minimum necessary automated cases, turning
fixedinto a checkable outcome.
Boundaries
It fits engineering debugging with observable errors or clear anomalies, especially when a fast convergence to a conclusion is needed. It is not intended for open-ended architecture exploration, pure capacity planning, or issues with no observable symptom. When evidence is insufficient, it marks assumptions and open questions rather than making destructive suggestions.
Use Cases
- Trace a production API 500 with one-line logs and isolate null or dependency init issues.
- Debug a test failure caused by out-of-bounds or state drift, then propose a minimal fix.
- Handle a user-reported anomaly under a no-API-change constraint and output verification steps.
- Before review, explain why a fix avoids regression and add the minimum test cases needed.
Best For
- Backend engineer handling incident retrospectives: turns scattered logs into an evidence-backed root cause.
- Frontend engineer working under API constraints: proposes the smallest fix and validation steps.
- Full-stack engineer inheriting legacy modules: isolates timing or state-sync defects and adds minimal tests.
- QA engineer validating releases: converts failures into manual checklists and open assumptions.
Related Skills
Analyzes code to extract control and data flow, then outputs Markdown with Mermaid source and high-resolution PNG diagrams.
For development and programming scenarios around VSCode and TypeScript IDE.
A TypeScript-oriented Windmill Wrap development reference.
A Python-based Selenium wrapper for engineering browser automation workflows.