dev

Umiejętność dedykowana dla asystentów AI pracujących w projekcie atopile. Oferuje szybką pętlę rozwojową: kompilacja powiązań Zig, uruchamianie zorganizowanego test runnera z raportami w formacie JSON i HTML, oraz odkrywanie i debugowanie flag konfiguracyjnych. Zawiera komendy CLI takie jak ato dev compile do budowania natywnych rozszerzeń oraz ato dev test --llm do uruchamiania testów z obsługą linii bazowych i filtrowania. Idealna dla inżynierów pracujących nad jądrem projektu, którzy potrzebują niezawodnego narzędzia do walidacji zmian w kodzie Zig i konfiguracji.

1. Aktywuj wirtualne środowisko Pythona poleceniem source .venv/bin/activate — to przygotuje zależności wymagane do pracy ze skill'em dev.
2. Skompiluj powiązania Zig i natywne rozszerzenia poleceniem ato dev compile. Ta komenda buduje grafy, typografy i powiązania sexp, które są konieczne do uruchomienia testów.
3. Uruchom testy za pomocą ato dev test --llm, które wykonuje zorganizowany test runner i generuje raporty w formatach JSON, HTML i LLM-friendly. Możesz filtrować testy flagą -k (np. ato dev test --llm -k solver).
4. Przejrzyj wygenerowane raporty testów znajdujące się w katalogu artifacts/ — test-report.json, test-report.html i test-report.llm.json zawierają szczegółowe wyniki.
5. Odkryj i zweryfikuj flagi konfiguracyjne w całym repozytorium poleceniem ato dev flags. Flagi te kontrolują zachowanie kompilacji (np. ZIG_NORECOMPILE, ZIG_RELEASEMODE) i znajdują się w src/faebryk/libs/util.py.
6. Dla zaawansowanego debugowania użyj opcji --view HEAD --open do porównania wyników z bieżącą gałęzią lub --reuse --baseline HEAD~1 do porównania z poprzednią wersją kodu.