What problem does it solve?
This Skill helps developers investigate a user-submitted issue by correlating timeline and debug metadata to pinpoint the first anomaly and guide a minimal code fix.
Core Features & Use Cases
- Forensic triage with trace correlation: Delegates to an
issue-forensics subagent to run targeted debug.py issue --timeline checks, correlate browser↔backend events, and identify the first anomaly.
- Root-cause hypothesis and actionable suspects: Produces structured JSON including
first_anomaly, root_cause_hypothesis, suspect_files, and relevant reproduction steps plus recent related commits.
- Optional encryption/sync invariant tracing: If the symptom suggests an encryption/decryption/chat sync fault, it triggers an
encryption-flow-tracer pass to localize the broken invariant.
Quick Start
Launch the skill with the issue identifier you want to investigate, then use the returned suspect files and hypothesis to apply a minimal fix and confirm it with the provided debug cleanup command.