mflux-testing

Skill do uruchamiania testów w projekcie mflux z obsługą generowania i porównywania obrazów. Pozwala na szybkie testy (fast), pełne testy ze słowymi testami (slow) oraz całą paczkę testów (full). Automatycznie zachowuje wygenerowane obrazy i artefakty do przeglądu, a jednocześnie chroni referencyjne obrazy golden przed przypadkowym nadpisaniem. Idealny do debugowania testów, raportowania niezgodności obrazów i walidacji zmian w konfiguracji modelu.

1. Zainstaluj skill w swoim projekcie mflux — upewnij się, że masz dostęp do Makefile i katalogów testowych.

2. Wybierz typ testu w zależności od potrzeb: uruchom make test-fast dla szybkich testów bez generowania obrazów, make test-slow dla pełnych testów ze słowymi testami i generowaniem obrazów, lub make test dla całej paczki testów. Zmienna MFLUX_PRESERVE_TEST_OUTPUT=1 jest już wbudowana w cele Makefile i automatycznie zachowuje wszystkie wygenerowane obrazy.

3. Jeśli testy się nie powiodą, przejrzyj nazwy testów, które uległy awarii, i przeanalizuj kluczowe komunikaty asercji. Wygenerowane obrazy i artefakty znajdują się na dysku — sprawdź je ręcznie, aby zidentyfikować przyczynę niezgodności.

4. Gdy napotkasz niezgodność między wygenerowanym obrazem a referencją golden, nigdy nie regeneruj referencyjnych obrazów automatycznie. Zamiast tego zgłoś ścieżki do obrazów i wyniki do przeglądu — zmianę referencji wykonaj tylko na wyraźne polecenie użytkownika.

5. Dla zmian dotyczących rozwiązywania konfiguracji modelu, ścieżek lokalnych lub zachowania CLI — dodaj lub zaktualizuj testy pokrywające zmienione zachowanie bezpośrednio w kodzie testowym zamiast polegać wyłącznie na weryfikacji ręcznej.