m13-domain-error
Projektuj obsługę błędów domenowych z strategią odzyskiwania i kontekstem dla użytkowników i deweloperów.
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do projektowania strategii obsługi błędów w aplikacjach. Pomaga kategoryzować błędy (użytkownika, wewnętrzne, systemowe), określić możliwość odzyskiwania i wybrać odpowiednią strategię: retry z backoffem dla błędów przejściowych, fallback dla degradowalnych, fail fast dla trwałych. Zawiera matrycę decyzyjną dla każdego typu błędu z informacją o odbiorcy (użytkownik końcowy, deweloper, ops) i wymaganym kontekście debugowania.
Jak używać
Zainstaluj skill m13-domain-error z repozytorium actionbook/rust-skills w katalogu skills/m13-domain-error.
Przed projektowaniem typów błędów w swojej aplikacji, odpowiedz na trzy kluczowe pytania: Kto widzi ten błąd (użytkownik końcowy, deweloper, ops)? Czy możliwe jest odzyskanie? Jaki kontekst jest potrzebny do debugowania (łańcuch wywołań, ID żądania, dane wejściowe).
Użyj matrycy kategoryzacji błędów do klasyfikacji: błędy użytkownika wymagają przyjaznych komunikatów i akcji, błędy wewnętrzne potrzebują szczegółów dla debugowania, błędy systemowe muszą być strukturyzowane dla alertów, błędy przejściowe powinny być ponawialne z backoffem, błędy trwałe wymagają szybkiego niepowodzenia i alertu.
Dla błędów przejściowych (NetworkError, ServiceUnavailable) zaplanuj strategię retry z exponential backoff. Dla błędów degradowalnych przygotuj fallback value. Dla błędów trwałych (ConfigInvalid, DataCorrupted) ustaw fail fast z alertingiem.
Dodaj wymagany kontekst do każdego błędu: łańcuch wywołań poprzez structured logging, ID żądania dla śledzenia, dane wejściowe w payload błędu dla debugowania.
Jeśli błąd dotyczy logiki biznesowej (np. niepowodzenia płatności), prześlij pytanie do warstwy domenowych ograniczeń (domain constraints) aby sprawdzić reguły biznesowe dla retry i wymagania dostępności.