speak-incident-runbook

Skill do zarządzania incydentami w platformie Speak. Pozwala na szybkie wdrożenie procedur reagowania na awarie API, w tym triażu, przełączenia na tryb offline i procedur odzyskiwania. Zawiera konfigurację autoryzacji, testy CI z mockowanymi odpowiedziami oraz obsługę błędów. Używaj gdy implementujesz runbook incydentów lub zarządzasz operacjami platformy do nauki języków Speak.

1. Upewnij się, że masz ukończoną konfigurację z umiejętności speak-install-auth oraz ważne dane uwierzytelniające API Speak.

2. Skonfiguruj runbook incydentów, ustawiając zmienne środowiskowe: SPEAK_API_KEY, SPEAK_APP_ID i NODE_ENV. Skill wykorzystuje GPT-4o do tutoringu AI i Whisper do rozpoznawania mowy.

3. Wdrożyć logikę obsługi incydentów poprzez inicjalizację klienta Speak i zdefiniowanie procedur triażu oraz fallbacku do trybu offline. Skill udostępnia dostęp do narzędzi Read, Write, Edit oraz poleceń Bash dla npm i curl.

4. Uruchom testy CI z mockowanymi odpowiedziami API, aby zweryfikować konfigurację. Testy powinny obejmować scenariusze takie jak ocena wymowy z pliku audio.

5. Wdrożyć obsługę błędów dla typowych kodów odpowiedzi (401 Unauthorized, 429 Rate Limited) i skonfigurować monitoring. Skill zawiera tabelę błędów z przyczynami i rozwiązaniami.

6. Uruchom polecenie npm test, aby zweryfikować, że runbook incydentów jest poprawnie skonfigurowany i pipeline CI z testami Speak API działa prawidłowo.