Session Investigator

Investiga los archivos de sesión e historial de fast-agent para diagnosticar por qué falló una ejecución.

Por evalstate · evalstate/fast-agent

Probado · Funciona ★ 8.0/10

Session Investigator — Investiga los archivos de sesión e historial de fast-agent para diagnosticar por qué falló una ejecución.

Qué hace

Investiga los archivos de sesión e historial de fast-agent para diagnosticar problemas. Úsala cuando una sesión termina de forma inesperada, al depurar bucles de herramientas, al correlacionar trazas de subagentes con sesiones principales, o al analizar el flujo y los tiempos de una conversación. Cubre los metadatos de session.json, el formato JSON del historial, la estructura de mensajes, la correlación llamada/resultado de herramientas y los patrones de fallo habituales.

Informe de la prueba

Se probó la instalación literal (clone+copy limpio, SKILL.md autocontenido, frontmatter en YAML estricto) junto con un history_dev.json de fast-agent fabricado con una llamada a herramienta colgada a propósito. Tanto el brazo con skill como el base identificaron correctamente el patrón Unanswered Tool Call en el índice de mensaje 5 y el mismo punto de truncamiento 0-4; el brazo con skill se adelantó solo por nombrar el patrón de fallo canónico y señalar que su propia receta de truncamiento con jq ancla de forma demasiado conservadora, así que la ganancia del A/B fue marginal. Nota: los comandos de la skill asumen en silencio que jq está instalado (ausente en la máquina de prueba y nunca listado como prerrequisito).

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

Instalación

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

Comandos y prompts de ejemplo

  • /session-investigatorInvestiga los archivos de sesión e historial de fast-agent para diagnosticar por qué falló una ejecución.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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