ispc-builtins

Best practices for creating and modifying ISPC builtin files. Use when adding target-specific optimizations, implementing new builtin functions, or working with the hierarchical target system.

1. Zainstaluj umiejętność w swoim środowisku Claude'a, wskazując repozytorium ISPC i ścieżkę .claude/skills/ispc-builtins. 2. Zapoznaj się z hierarchią celów zdefiniowaną w src/builtins.cpp — zrozumienie, że każdy cel dziedziczy funkcje od swojego rodzica (np. avx512skx dziedziczy z generic), jest kluczowe do prawidłowego projektowania builtin'ów. 3. Gdy dodajesz nową funkcję wbudowaną, określ, w którym pliku LLVM IR powinna się znaleźć — jeśli funkcja jest specyficzna dla architektury (np. tylko AVX-512), umieść ją w pliku docelowym; jeśli jest ogólna, umieść w generic. 4. Wykorzystaj system linkowania: kompilator najpierw szuka symboli w builtinach docelowych, a następnie w builtinach rodzica — dzięki temu unikasz duplikacji kodu i utrzymujesz spójność. 5. Testuj implementacje na docelowej architekturze, aby upewnić się, że funkcje działają poprawnie i że hierarchia działa jak oczekiwano — brakujące symbole powinny być automatycznie rozwiązane z poziomu rodzica. 6. Dokumentuj zmiany w kontekście hierarchii — zaznacz, czy funkcja jest nowa, czy zastępuje implementację rodzica, aby ułatwić przyszłe utrzymanie.