gentleman-trainer

Gentleman Trainer to system treningowy Vima zbudowany na wzorze gry RPG dla Gentleman.Dots. Skill aktywuje się podczas edycji plików treningowych i pozwala dodawać nowe moduły ćwiczeń, zadania oraz mechaniki progresji. Zawiera gotowe wzorce dla ćwiczeń poziomych, pionowych, obiektów tekstowych, makr i wyrażeń regularnych. Każde ćwiczenie ma poziom trudności, misję do wykonania, wiele poprawnych rozwiązań i wyjaśnienie edukacyjne. Moduły odblokowują się sekwencyjnie – musisz pokonać bossa, aby przejść do następnego poziomu.

1. Zainstaluj skill w swoim projekcie Gentleman.Dots, umieszczając pliki w katalogu skills/gentleman-trainer. Skill automatycznie aktywuje się, gdy edytujesz pliki w ścieżce installer/internal/tui/trainer/.

2. Zdefiniuj nowy moduł treningowy jako stałą ModuleID w pliku types.go. Każdy moduł musi mieć unikalny identyfikator (np. "horizontal", "vertical", "textobjects"). Dodaj go do listy konstant ModuleID razem z innymi istniejącymi modułami.

3. Utwórz strukturę Exercise dla każdego ćwiczenia. Wypełnij wymagane pola: ID ćwiczenia, przynależny moduł, poziom trudności (1-10), typ (lesson, practice lub boss), kod do edycji, pozycję kursora, misję do wykonania oraz wszystkie prawidłowe rozwiązania.

4. Dodaj do ćwiczenia pole Optimal z najkrótszym rozwiązaniem, Hint z podpowiedzią oraz Explanation z wyjaśnieniem edukacyjnym. Ustaw TimeoutSecs na czas przed pokazaniem rozwiązania i Points na liczbę punktów za ukończenie.

5. Skonfiguruj kolejność odblokowywania modułów w systemie progresji. Użytkownik musi pokonać bossa każdego modułu, aby odblokować następny. Upewnij się, że boss fight jest zdefiniowany jako ćwiczenie typu "boss" z odpowiednią trudnością.

6. Przetestuj nowy moduł lub ćwiczenie, uruchamiając symulator Vima i weryfikując, że misje są jasne, rozwiązania działają poprawnie i progresja odblokowuje się zgodnie z planem.