python-error-handling

Umiejętność zawierająca sprawdzone wzorce obsługi błędów w Pythonie. Nauczysz się implementować wczesną walidację danych, projektować hierarchie wyjątków, obsługiwać częściowe porażki w operacjach zbiorczych i budować przyjazne użytkownikowi komunikaty o błędach. Idealna do tworzenia solidnych API, przetwarzania wsadowego i konwersji danych zewnętrznych na typy domenowe. Każdy wzorzec pokazuje, jak zachować kontekst błędu dla łatwiejszego debugowania i zwiększyć niezawodność systemu.

1. Zainstaluj umiejętność w swoim projekcie agenta, dodając ją do konfiguracji skills lub importując z repozytorium wshobson/agents. 2. Przeczytaj sekcję "When to Use This Skill" aby zidentyfikować, gdzie w Twoim kodzie powinna być zastosowana — najczęściej na granicach API, przy walidacji parametrów użytkownika lub w logice przetwarzania danych. 3. Zastosuj wzorzec "Fail Fast": umieść walidację wszystkich wejść na początku funkcji, zanim wykonasz kosztowne operacje, i raportuj wszystkie błędy walidacji jednocześnie. 4. Dla każdego punktu walidacji użyj odpowiedniego typu wyjątku (np. ValueError dla błędnych wartości) z jasnym komunikatem wyjaśniającym co się nie powiodło, dlaczego i jak to naprawić. 5. W operacjach zbiorczych (batch processing) śledź sukcesy i porażki osobno zamiast przerywać całą operację przy pierwszym błędzie — to jest wzorzec "Partial Failures". 6. Łańcuchuj wyjątki aby zachować pełny ślad błędu dla debugowania, używając klauzuli "from" w Pythonie — dzięki temu łatwiej będzie znaleźć pierwotną przyczynę problemu.