Session Investigator

Investigue les fichiers de session et d'historique fast-agent pour diagnostiquer l'échec d'une exécution.

par evalstate · evalstate/fast-agent

Testé · Fonctionne ★ 8.0/10

Session Investigator — Investigue les fichiers de session et d'historique fast-agent pour diagnostiquer l'échec d'une exécution.

Ce que fait

Investigue les fichiers de session et d'historique fast-agent pour diagnostiquer des problèmes. À utiliser quand une session s'est terminée de façon inattendue, pour déboguer des boucles d'outils, pour corréler les traces de sous-agents avec les sessions principales, ou pour analyser le flux et le timing d'une conversation. Couvre les métadonnées session.json, le format JSON de l'historique, la structure des messages, la corrélation appel/résultat d'outil, et les motifs d'échec courants.

Rapport de test

Testé en installation tel quel (clone+copie propre, SKILL.md autonome, frontmatter YAML strict) plus un history_dev.json fast-agent fabriqué et truffé d'un appel d'outil resté sans réponse. Les deux bras, avec et sans skill, ont correctement identifié le motif Unanswered Tool Call à l'index de message 5 et le même point de troncature 0-4 ; le bras avec skill n'a pris l'avantage qu'en nommant le motif d'échec canonique et en signalant que sa propre recette de troncature jq est ancrée de façon trop conservatrice, donc le gain de l'A/B était marginal. À noter que les commandes du skill supposent silencieusement que jq est installé (absent sur la machine de test et jamais listé comme prérequis).

Testé le: 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

Commandes et exemples de prompts

  • /session-investigatorInvestigue les fichiers de session et d'historique fast-agent pour diagnostiquer l'échec d'une exécution.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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