php-guidelines-from-spatie

Umiejętność Claude'a zawierająca wytyczne kodowania PHP i Laravel opracowane przez Spatie. Opisuje konwencje nazewnictwa, deklaracje typów, strukturę klas i zasady dokumentacji, które prowadzą do bardziej czytelnego i łatwiejszego w utrzymaniu kodu. Obejmuje standardy PSR-1, PSR-2 i PSR-12, użycie typed properties zamiast docbloków, nullable types oraz dokumentację generycznych typów kolekcji.

1. Zainstaluj umiejętność w Claude'a, dodając plik z wytycznymi do katalogu skills w konfiguracji Claude'a (zazwyczaj ~/.config/claude/skills/).

2. Podczas pisania lub recenzji kodu PHP/Laravel, odwołaj się do tej umiejętności, aby Claude przestrzegał wytycznych Spatie dotyczących struktury klas, deklaracji typów i docbloków.

3. Pamiętaj o głównej zasadzie: najpierw stosuj konwencje Laravel – jeśli Laravel ma udokumentowany sposób na coś, użyj go, a od konwencji odchodź tylko gdy masz jasne uzasadnienie.

4. Przy definiowaniu właściwości klasy używaj typed properties zamiast docbloków, a gdy to możliwe, skorzystaj z constructor property promotion.

5. W docblockach zawsze importuj nazwy klas (nigdy nie używaj w pełni kwalifikowanych nazw) i dokumentuj typy iterowalne z kluczami i wartościami, np. @return Collection<int, User>.

6. Dla metod w pełni type-hintowanych pomijaj docbloki, chyba że potrzebujesz dodać opis – zamiast tego używaj notacji ?Type dla nullable types zamiast Type|null.