Session Investigator

Analizza i file di sessione e cronologia di fast-agent per capire perché un'esecuzione è fallita.

di evalstate · evalstate/fast-agent

Promosso ★ 8.0/10

Session Investigator — Analizza i file di sessione e cronologia di fast-agent per capire perché un'esecuzione è fallita.

Cosa fa

Analizza i file di sessione e cronologia di fast-agent per diagnosticare i problemi. Da usare quando una sessione termina in modo inatteso, per il debug di loop di tool, per correlare le tracce dei sub-agent con le sessioni principali, o per analizzare il flusso e i tempi della conversazione. Copre i metadati di session.json, il formato JSON della cronologia, la struttura dei messaggi, la correlazione tra chiamate e risultati dei tool, e i pattern di fallimento più comuni.

Rapporto di test

Testata l'installazione verbatim (clone+copy pulito, SKILL.md autonomo, frontmatter YAML rigoroso) più un history_dev.json di fast-agent fabbricato con una tool call rimasta senza risposta. Sia il braccio con lo skill sia quello base hanno identificato correttamente il pattern Unanswered Tool Call all'indice messaggio 5 e lo stesso punto di troncamento 0-4; il braccio con lo skill ha avuto un vantaggio solo nel nominare il pattern di fallimento canonico e nel segnalare che la sua stessa ricetta di troncamento con jq è ancorata in modo troppo conservativo, quindi il guadagno dell'A/B è stato marginale. Da notare che i comandi dello skill danno per scontato, senza dirlo, che jq sia installato (assente sulla macchina di test e mai elencato come prerequisito).

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

Installazione

git clone https://github.com/evalstate/fast-agent
cd fast-agent
mkdir -p ~/.claude/skills
cp -r examples/hf-toad-cards/skills/session-investigator ~/.claude/skills/session-investigator

Comandi e prompt di esempio

  • /session-investigatorAnalizza i file di sessione e cronologia di fast-agent per capire perché un'esecuzione è fallita.

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

  • Why did this fast-agent session end unexpectedly
  • Correlate this sub-agent trace with the main session
  • Debug this tool loop using the session history