textual-ui-developer

Develop and improve the MassGen Textual TUI by running it in a browser via textual-serve and using Claude's browser tool for visual feedback.

1. Zainstaluj skill jako część repozytorium MassGen i upewnij się, że masz dostęp do katalogu massgen/tests/frontend oraz skryptów w scripts/.

2. Jeśli debugujesz problem z renderowaniem lub porządkowaniem osi czasu, zacznij od odtworzenia zdarzenia z pliku events.jsonl bez kosztów API: uruchom uv run python scripts/dump_timeline_from_events.py /ścieżka/do/events.jsonl [agent_id] aby zobaczyć tekstową reprezentację, lub dodaj flagę --tui aby wyświetlić interfejs w terminalu.

3. Aby przetestować zmianę layoutu lub stylowania w rzeczywistej powłoce Textual, uruchom uv run python scripts/dump_timeline_from_events.py --tui-real /ścieżka/do/events.jsonl [agent_id] — to odtwarza zdarzenia w pełnym interfejsie bez wywołań API.

4. Zweryfikuj swoje ustalenia, uruchamiając testy regresji: uv run pytest massgen/tests/frontend/test_timeline_transcript_golden.py -q dla testów transkryptu lub uv run pytest massgen/tests/frontend/test_timeline_snapshot_scaffold.py -q dla testów snapshotu. Jeśli chcesz zaktualizować wzorce, dodaj flagę UPDATE_GOLDENS=1 lub --snapshot-update.

5. Gdy potrzebujesz pełnego testu interfejsu, uruchom uv run pytest massgen/tests/frontend -q aby wykonać całą paczkę testów frontend/TUI.

6. Jeśli problem wymaga interakcji na żywo z modelem, uruchom massgen --display textual lub massgen --textual-serve — ale rób to tylko po wyczerpaniu metod deterministycznych, aby zaoszczędzić koszty.