systematic-debugging

Solid

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Code & Development 400 stars 16 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Execute → Bug? Test failure? Unexpected behavior? → **Find root cause first. No fixes without evidence.** 1. Isolate: read error → reproduce → check git diff → drill upward through diagnostic layers: L1 symptom → L2 logic → L3 system → L4 architecture → L5 cross-system contract → L6 platform constraint → L7 spec gap. Stop when no deeper "why" remains OR terminal unactionable (T1-T4). 2. Identify owner: compare with working code → locate canonical owner → flag duplicate owners as a finding 3. Before fixing, run Patch-Shape Triage and Ripple Signal Triage if the candidate fix touches shared/core/cross-module behavior, contract, source-of-truth, fallback, adapter, duplicate owner, producer+consumer, or consumer-side patching. Also run Pre-Edit Complexity Check when the candidate fix touches an overloaded owner or may worsen source complexity. 4. Prove: one hypothesis → minimal test → iterate. 3+ failed fixes = question architecture, do not attempt another code fix. After fix, if any symptom persists → differential diagnosis (Phase 4 Step 4bis). 5. Fix: failing test → minimal code at canonical owner → verify → Reflection + architecture review → repair + retirement track → Done when: confidence ≥ B, both tracks explicit, DeeperCause answered "no" with evidence, no H-class hard signal still active. # Systematic Debugging ## Overview Random fixes waste time and create new bugs. Symptom fixes are failure. This skill is the canonical debugging work...

Details

Author
GanyuanRan
Repository
GanyuanRan/Aegis
Created
1 months ago
Last Updated
today
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Solid

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

233 Updated today
jamditis
Code & Development Listed

systematic-debugging

Use this skill whenever a test fails, a code review surfaces a defect, or a bug is reported, to perform structured root-cause analysis rather than trial-and-error patches. Walks symptom → narrow → reproduce → minimal repro → root cause → fix → regression test. Outputs a debug log entry that feeds into Memory and AUDIT_BUNDLE. Chinese trigger examples: "调试", "找 bug 根因", "系统化调试", "Bug 定位", "test failure 调试", "review 反馈 修复". Do NOT use for stylistic feedback (just fix), do NOT use for known one-line fixes. Success = root cause identified with evidence, fix applied at root cause level, regression test added.

72 Updated today
charliehzm
Code & Development Listed

systematic-debugging

Comprehensive 4-phase debugging methodology for complex bugs. Use for bugs that aren't immediately obvious or have resisted quick fixes. Keywords: bug, error, fix, debug, broken, crash, fail, exception

0 Updated today
cheemsiulord
Code & Development Listed

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

7 Updated yesterday
yeaight7
AI & Automation Solid

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes. Requires root cause investigation first.

1,034 Updated today
a5c-ai