tech-debt-analyzer

Narzędzie do systematycznej analizy długu technicznego w Twojej bazie kodu. Automatycznie wykrywa zapachy kodu, problemy architektoniczne, zależności, brakującą dokumentację i luki bezpieczeństwa. Generuje raporty z kategoryzacją problemów według ważności i tworzy rejestr długu technicznego, który ułatwia śledzenie i zarządzanie jakością kodu w projektach JavaScript/TypeScript.

1. Zainstaluj skill w swoim środowisku Claude, wskazując repozytorium ailabs-393/ai-labs-claude-skills. Upewnij się, że masz zainstalowany Python 3 i dostęp do katalogów projektu.

2. Przygotuj projekt do analizy — upewnij się, że struktura katalogów zawiera folder src z plikami TypeScript/JavaScript oraz plik package.json z listą zależności.

3. Uruchom automatyczną detekcję zapachów kodu poleceniem skierowanym do skill'u, aby przeskanować bazę kodu. Narzędzie przeanalizuje rozmiar plików, złożoność funkcji, komentarze TODO/FIXME/HACK, instrukcje console, użycie typu any, długość parametrów, zagnieżdżenie kodu i liczby magiczne.

4. Uruchom analizę zależności, aby sprawdzić package.json pod kątem przestarzałych pakietów, luk bezpieczeństwa i problemów z wersjami. Skill zidentyfikuje potencjalne zagrożenia w łańcuchu zależności.

5. Przejrzyj wygenerowany raport w formacie markdown, który zawiera podsumowanie liczby problemów, podział według ważności (HIGH, MEDIUM, LOW) oraz szczegółowe listy problemów pogrupowane po typie.

6. Wykorzystaj szablon rejestru długu technicznego dostarczony przez skill do dokumentacji znalezionych problemów, przypisania priorytetów i śledzenia postępu naprawy w Twoim projekcie.