tech-debt-analyzer

This skill should be used when analyzing technical debt in a codebase, documenting code quality issues, creating technical debt registers, or assessing code maintainability. Use this for identifying code smells, architectural issues, dependency problems, missing documentation, security vulnerabilities, and creating comprehensive technical debt documentation.

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.