Session Investigator

Undersöker fast-agent-sessions- och historikfiler för att diagnostisera varför en körning misslyckades.

av evalstate · evalstate/fast-agent

Testad · Fungerar ★ 8.0/10

Session Investigator — Undersöker fast-agent-sessions- och historikfiler för att diagnostisera varför en körning misslyckades.

Vad den gör

Undersöker fast-agent-sessions- och historikfiler för att diagnostisera problem. Använd när en session avslutades oväntat, vid felsökning av verktygsloopar, vid korrelering av sub-agent-spår med huvudsessioner, eller vid analys av konversationsflöde och tajming. Täcker session.json-metadata, historikens JSON-format, meddelandestruktur, korrelation mellan verktygsanrop/resultat och vanliga felmönster.

Testrapport

Testade installation ord för ord (ren clone+copy, självständig SKILL.md, strikt YAML-frontmatter) plus en påhittad fast-agent history_dev.json inplanterad med ett hängande verktygsanrop. Både skill- och basarmen identifierade korrekt mönstret Unanswered Tool Call vid meddelandeindex 5 och samma trunkeringspunkt vid 0-4; skillarmen låg bara marginellt före genom att namnge det kanoniska felmönstret och flagga att dess eget jq-trunkeringsrecept ankrar för konservativt, så A/B-vinsten var marginell. Notera att skillens kommandon tyst förutsätter att jq är installerat (saknades på testmaskinen och listades aldrig som en förutsättning).

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

Installation

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

Kommandon och exempelprompter

  • /session-investigatorUndersöker fast-agent-sessions- och historikfiler för att diagnostisera varför en körning misslyckades.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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