axiom-metal-migration-diag
Systematyczna diagnostyka problemów przy portowaniu grafiki na Metal
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do szybkiego znalezienia przyczyny awarii Metal — czarny ekran, błędy shaderów, artefakty renderowania, problemy z wydajnością. Przeprowadzi Cię przez drzewo decyzyjne: od włączenia walidacji Metal w Xcode, przez sprawdzenie render pass descriptor i pipeline state, aż do inspekcji bufora wierzchołków w GPU Frame Capture. Zamiast godzin ślepego debugowania, uzyskasz konkretne kroki naprawy w ciągu minut.
Jak używać
Zainstaluj skill axiom-metal-migration-diag w swoim środowisku Claude/Codex. Skill jest dostępny na licencji MIT i wspiera iOS 12+, macOS 10.14+ i tvOS 12+.
Przed każdym debugowaniem włącz walidację Metal w Xcode: przejdź do Edit Scheme → Run → Diagnostics i zaznacz opcje Metal API Validation, Metal Shader Validation oraz GPU Frame Capture (Metal). To zajmie 30 sekund i zaoszczędzi Ci godzin ślepych prób.
Uruchom skill i opisz symptom: czarny ekran, błędy kompilacji shaderów, złe kolory, regresję wydajności, artefakty renderowania lub crash GPU. Skill przeprowadzi Cię przez drzewo decyzyjne dla Twojego problemu.
Postępuj zgodnie z krokami diagnostycznymi: sprawdź czy view.currentRenderPassDescriptor i view.currentDrawable zwracają wartości, czy MTKView.device jest ustawiony, czy pipeline state się tworzy bez błędów, czy draw calls są wydawane.
Użyj GPU Frame Capture do inspekcji bufora wierzchołków i powiązanych zasobów. Skill pokaże Ci, które setVertexBuffer i setFragmentTexture mogą być źródłem problemu.
Zastosuj sugerowane poprawki: upewnij się że view jest widoczny na ekranie, nazwy funkcji shader zgadzają się z biblioteką, bufory są jawnie powiązane każdą klatkę, offsety bufora są poprawne.