axiom-metal-migration-diag
Use when ANY Metal porting issue occurs - black screen, rendering artifacts, shader errors, wrong colors, performance regressions, GPU crashes
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Use when ANY Metal porting issue occurs - black screen, rendering artifacts, shader errors, wrong colors, performance regressions, GPU crashes
How to use
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.