debug-hooks

Debug Hooks to umiejętność do diagnozowania problemów z hookami w Claude Code. Kiedy hook nie uruchamia się, produkuje błędne dane lub zachowuje się nieoczekiwanie, ta umiejętność prowadzi Cię przez systematyczny workflow debugowania. Sprawdzisz cache projektu, zweryfikujesz rejestrację hooków w ustawieniach, potwierdzisz istnienie plików hooków i przetestujesz je ręcznie. Narzędzie wykorzystuje Bash, Read i Grep do analizy logów, konfiguracji oraz śledzenia cichych błędów w detached procesach.

1. Zainstaluj umiejętność w swoim projekcie Claude, umieszczając folder debug-hooks w katalogu .claude/skills/.

2. Zacznij od obserwacji – sprawdź cache projektu poleceniem ls -la $CLAUDE_PROJECT_DIR/.claude/cache/ oraz pliki logów za pomocą tail, aby zobaczyć, co się dzieje w tle.

3. Zweryfikuj rejestrację hooków w pliku $CLAUDE_PROJECT_DIR/.claude/settings.json – poszukaj wpisów SessionEnd, PostToolUse lub UserPromptSubmit, aby upewnić się, że hook jest zarejestrowany. Sprawdź też globalny plik ~/.claude/settings.json, ponieważ hooki łączą się z obu lokalizacji.

4. Potwierdź, że pliki hooków istnieją w katalogu .claude/hooks/ – szukaj plików .sh lub skompilowanych bundli .mjs, jeśli używasz TypeScript.

5. Przetestuj hook ręcznie, przekazując do niego JSON z danymi testowymi – na przykład dla SessionEnd hook wyślij JSON z session_id i reason, a dla PostToolUse hook podaj tool_name i tool_input.

6. Jeśli hook wciąż nie działa, sprawdź, czy nie używa detached spawn z stdio: 'ignore' – ten wzorzec ukrywa błędy. Dodaj tymczasowe logowanie do pliku, aby zobaczyć rzeczywisty błąd.