C
code-consistency-logging-standards
Sprawdzaj poziomy logowania w Pythonie i wyłapuj błędy w obsłudze wyjątków
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do automatycznego skanowania kodu Python w poszukiwaniu błędów w logowaniu. Identyfikuje nieprawidłowe poziomy ważności (DEBUG, INFO, WARNING, ERROR, CRITICAL) i brakujące obsługi wyjątków. Pomaga utrzymać spójność i jakość logów w projekcie. Używaj podczas przeglądów kodu, aby upewnić się, że wyjątki są logowane na poziomie ERROR, normalne operacje na INFO, a degradacja usługi na WARNING. Zawiera drzewo decyzyjne do wyboru właściwego poziomu logowania dla każdej sytuacji.
Jak używać
- Zainstaluj skill w swoim środowisku Claude, dodając go do katalogu skills projektu. Skill wymaga dostępu do narzędzi Read, Glob i Grep do skanowania plików.
- Przygotuj pliki Python do przeanalizowania. Skill skanuje kod w poszukiwaniu instrukcji logger.info(), logger.error(), logger.warning() i logger.exception().
- Uruchom skill na wybranym pliku lub katalogu. Skill przeskanuje kod i porówna każde logowanie z drzewem decyzyjnym poziomów ważności.
- Przejrzyj raport. Skill wskaże miejsca, gdzie poziom logowania nie pasuje do sytuacji, np. wyjątek zalogowany jako INFO zamiast ERROR, lub normalna operacja zalogowana jako ERROR.
- Zwróć uwagę na brakujące logger.exception() w blokach except. Skill flaguje wyjątki logowane ręcznie bez stosu wywołań.
- Zastosuj poprawki zgodnie z wytycznymi: wyjątki zawsze ERROR lub logger.exception(), operacje udane to INFO, degradacja usługi to WARNING, diagnostyka szczegółowa to DEBUG.