develop-web-game

Umiejętność dla Codex do tworzenia i iteracji gier HTML/JavaScript z niezawodną pętlą rozwojową. Implementujesz małe zmiany, uruchamiasz testy oparte na Playwrighcie z pauzami, sprawdzasz zrzuty ekranu i błędy konsoli. Workflow opiera się na cyklu: implementacja → akcja → pauza → obserwacja → dostosowanie. Wymaga funkcji render_game_to_text do odczytu stanu gry i advanceTime(ms) do deterministycznego sterowania klatkami.

1. Skonfiguruj zmienne środowiskowe, ustawiając CODEX_HOME (domyślnie ~/.codex), WEB_GAME_CLIENT na ścieżkę skryptu Playwrighta oraz WEB_GAME_ACTIONS na plik referencyjny action_payloads.json. Umiejętność instaluje się automatycznie w katalogu $CODEX_HOME/skills.

2. Zdefiniuj pojedynczą funkcję lub zachowanie do implementacji. Każda iteracja powinna skupiać się na jednym celu, aby ułatwić testowanie i debugowanie.

3. Implementuj najmniejsze możliwe zmiany w kodzie gry (HTML/JavaScript). Upewnij się, że gra ma pojedynczy canvas oraz funkcję window.render_game_to_text() zwracającą tekstową reprezentację stanu gry, którą skrypt testowy może odczytać.

4. Dodaj hook window.advanceTime(ms) do gry, aby Playwright mógł deterministycznie sterować przebiegiem klatek. Bez tego testy mogą być niestabilne. Jeśli plik progress.md istnieje, przeczytaj go i potwierdź oryginalny prompt użytkownika na początku (prefiks: "Original prompt:"), a także zanotuj pozostałe TODO i sugestie. Jeśli plik nie istnieje, utwórz go z oryginalnym promptem na górze.

5. Sprawdź dostępność Playwrighta — uruchom npx playwright --version lub zainstaluj go jako lokalną zależność. Następnie uruchom skrypt testowy z $WEB_GAME_CLIENT po każdej znaczącej zmianie kodu, aby zweryfikować działanie gry.

6. Przeanalizuj wyniki testów: zrzuty ekranu, tekstową reprezentację stanu gry oraz błędy z konsoli. Dostosuj kod na podstawie obserwacji i powtórz cykl aż do osiągnięcia celu iteracji.