refactor-assist

Narzędzie do szybkiej analizy kodu i uzyskania konkretnych propozycji jego ulepszenia. Wskazuje problemy z czytelności, duplikacją i wzorcami, wyświetlając zmiany w czytelnym formacie diff. Działa bez konfiguracji – wystarczy wskazać plik, a AI przeanalizuje go pod kątem modernizacji i bezpieczeństwa typów. Idealny do przygotowania się do code review, spłacania długu technicznego lub nauki lepszych praktyk programistycznych.

1. Upewnij się, że masz zainstalowany Node.js 18 lub nowszy oraz ustawioną zmienną środowiskową OPENAI_API_KEY z kluczem do OpenAI.

2. Otwórz terminal w katalogu projektu i uruchom narzędzie wskazując plik do analizy: npx ai-refactor src/utils.ts – zobaczysz listę sugestii refaktoryzacji z kolorowymi diffami pokazującymi proponowane zmiany.

3. Przejrzyj każdą sugestię i oceń, czy ma sens w kontekście Twojego kodu – narzędzie skupia się na czytelności, wzorcach i bezpieczeństwie typów, ale ostateczna decyzja należy do Ciebie.

4. Jeśli chcesz zastosować sugestie automatycznie, uruchom polecenie z flagą --apply: npx ai-refactor src/utils.ts --apply – zmiana będzie natychmiast wdrożona w pliku.

5. Jeśli chcesz skupić się na konkretnym obszarze kodu, użyj flagi --focus: npx ai-refactor src/api.ts --focus "error handling" – analiza będzie bardziej ukierunkowana.

6. Po zastosowaniu zmian uruchom testy, aby upewnić się, że nic się nie zepsuło, a następnie zacommituj zmiany do repozytorium.