Kiro Debug

Protocollo di debug root-cause-first che blocca le patch a tentoni dopo un fix fallito

di gotalab · gotalab/cc-sdd

Promosso ★ 8.8/10

Kiro Debug — Protocollo di debug root-cause-first che blocca le patch a tentoni dopo un fix fallito

Cosa fa

Struttura il debug come raccolta di prove prima della correzione: legge l'errore esatto, ispeziona repo/config runtime (package.json, git diff, file di build), consulta eventualmente la documentazione, poi classifica il guasto in una delle dieci categorie ed emette un Debug Report strutturato con FIX_PLAN, VERIFICATION, NEXT_ACTION e CONFIDENCE. Si attiva quando un implementatore è bloccato, la verifica fallisce, o i tentativi di correzione ripetuti non convergono — rifiuta esplicitamente di proporre una patch prima di aver stabilito la causa radice.

Rapporto di test

Su un vero test pytest fallito (bug di divisione intera): la baseline è saltata dritta a un fix di una riga, lo skill ha prodotto un Debug Report strutturato (ROOT_CAUSE, CATEGORY, FIX_PLAN, NEXT_ACTION) azionabile da un agente orchestratore.

Testato il: 2026-07-10 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/gotalab/cc-sdd
cd cc-sdd
mkdir -p ~/.claude/skills
cp -r tools/cc-sdd/templates/agents/antigravity-skills/skills/kiro-debug ~/.claude/skills/kiro-debug

Comandi e prompt di esempio

  • /kiro-debugProtocollo di debug root-cause-first che blocca le patch a tentoni dopo un fix fallito

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • My fix didn't work, help me find the actual root cause
  • Debug this failing build and give me a structured debug report
  • Stop guessing fixes and diagnose why this test keeps failing