session-analyzer

Session Analyzer to narzędzie do analizy zakończonych sesji Claude Code. Pozwala sprawdzić, czy umiejętność (skill) działała zgodnie z dokumentacją SKILL.md, zweryfikować prawidłowe wywołanie komponentów (SubAgents, Hooks, Tools), potwierdzić utworzenie artefaktów oraz wykryć błędy i odchylenia od oczekiwanego zachowania. Idealne do debugowania i walidacji złożonych przepływów pracy w agentach Claude'a.

1. Przygotuj identyfikator sesji (UUID) oraz ścieżkę do pliku SKILL.md, który zawiera specyfikację umiejętności do weryfikacji. Opcjonalnie przygotuj dodatkowe kryteria walidacji, jeśli chcesz sprawdzić coś poza standardową specyfikacją.

2. Umiejętność automatycznie zlokalizuje pliki sesji w katalogu ~/.claude/, szukając głównego logu sesji, dziennika debugowania oraz transkryptów agentów (jeśli były używane). Możesz również ręcznie uruchomić skrypt find-session-files.sh z parametrem sessionId, aby znaleźć pliki.

3. Zweryfikuj, że wszystkie wymagane pliki sesji istnieją. Jeśli brakuje dziennika debugowania, analiza będzie ograniczona, ale umiejętność będzie kontynuować pracę z dostępnymi danymi.

4. Umiejętność przeanalizuje plik SKILL.md i wyodrębni oczekiwane komponenty z sekcji YAML, w tym hooks PreToolUse, wywołania narzędzi oraz artefakty.

5. Porówna rzeczywiste zdarzenia z dziennika sesji z oczekiwanym zachowaniem. Sprawdzi, czy SubAgents, Hooks i Tools były wywoływane prawidłowo, czy utworzono lub usunięto oczekiwane pliki, oraz czy nie pojawiły się nieoczekiwane błędy.

6. Otrzymasz raport z wynikami weryfikacji, wskazujący zgodność z specyfikacją oraz listę wszelkich wykrytych anomalii lub odchyleń od dokumentacji.