← ClaudeAtlas

dhpk-root-cause-investigationlisted

Root-cause investigation workflow for unexpected behavior, test failures, performance regressions, data inconsistencies, and cross-layer data-flow tracing. Use when users ask to investigate or trace a bug, regression, flaky test, or root cause (including 測試失敗、效能異常、調查 Bug、追蹤資料流). Not for direct implementation when the root cause is already confirmed, ordinary code review, or pure feature work. Output: a phase-based evidence report, confirmed root cause or explicit blocked state, solution options, stop-loss state, and next actions.
hmj1026/dhpk · ★ 2 · AI & Automation · score 71
Install: claude install-skill hmj1026/dhpk
# Bug Investigation Skill ## Overview Use a five-phase evidence loop to move from symptom to root cause, then to a bounded repair handoff: `Clarify → Gather evidence → Trace and confirm → Design the fix → Preserve knowledge` Keep the investigation record current. Every conclusion must point to evidence; every unresolved claim must be labelled as a hypothesis or blocker. ## Symptom-specific red loop Before broad theorizing, turn the reported symptom into a **symptom-specific** reproduction: a minimal input, expected/actual output, and a **red-capable** assertion or probe that fails for the same reason. Minimize the case until one boundary or transition can be observed. If the failure cannot be reproduced, record that as inconclusive evidence instead of weakening the assertion. Maintain a **ranked** list of **falsifiable** hypotheses. For each hypothesis, name the prediction, the smallest discriminating check, and the evidence that would reject it. Do not promote a hypothesis because it is plausible or because it matches a familiar bug pattern. Instrumentation is temporary and tagged with its purpose, owner, and cleanup condition. Remove or quarantine debug probes after confirmation, retain only the evidence needed for a regression test, and record whether a **postmortem** or follow-up is needed for monitoring, data repair, or process change. ## Redact before sharing evidence Redact secrets from every command, output, log excerpt, trace, and captured artifact before p