axiom-uikit-animation-debugging

Skill do systematycznego diagnozowania problemów z CAAnimation w iOS. Pomaga znaleźć przyczyny niepalących się completion handlerów, niedopasowanych czasów animacji, jankowania podczas interakcji z gestami oraz różnic między symulatorem a rzeczywistym urządzeniem. Skupia się na CATransaction timing, stanie warstw i założeniach dotyczących frame rate'u — 90% problemów to nie błędy Core Animation, lecz błędy konfiguracji. Wymaga testowania na rzeczywistym urządzeniu przed wdrożeniem.

1. Zainstaluj skill w swoim projekcie Claude/Copilot, wskazując katalog axiom-uikit-animation-debugging z repozytorium.

2. Gdy napotkasz problem z animacją CAAnimation (completion handler nie pali się, czas trwania nie zgadza się z rzeczywistością, animacja wygląda źle na urządzeniu), uruchom skill i opisz symptomy — na przykład "completion handler pali się w symulatorze, ale nie na urządzeniu" lub "spring animation jankuje na starszych iPhone'ach".

3. Skill przeprowadzi cię przez obowiązkowe pierwsze kroki diagnostyczne: dodanie print statement'ów do completion handlera, aby sprawdzić czy w ogóle się pali, oraz sprawdzenie czy self nie stał się nil z powodu weak reference.

4. Skill analizuje CATransaction timing i layer state — najczęstsze przyczyny problemów. Zwraca uwagę na założenia dotyczące frame rate'u, które mogą być poprawne w symulatorze (60Hz), ale zawodzą na rzeczywistych urządzeniach (zmienny frame rate, throttling CPU).

5. Skill zaleca testowanie na rzeczywistym urządzeniu (najstarszym wspieranym modelem) przed wdrożeniem — symulator ukrywa wiele problemów czasowania, które ujawniają się w produkcji.

6. Na podstawie diagnostyki skill sugeruje konkretne poprawki: zmianę CATransaction konfiguracji, dostosowanie timing parameters lub refaktoryzację interakcji między gestami a animacjami.