Протягом років наші гайдлайни з написання коду були основою роботи в Spatie. Вони забезпечують цілісність коду в кожному проєкті та кожному PR. Коли з’явилися ШІ-асистенти, ми зрозуміли: ці інструменти мають дотримуватися тих самих правил. Ніхто не хоче виправляти за ШІ string|null на ?string або перейменовувати контролери, названі в однині.
Раніше ми випустили spatie/boost-spatie-guidelines — пакет, що інтегрував наші правила в Laravel Boost. Він добре працював, але був обмежений лише Boost. З розвитком skills.sh як відкритої екосистеми для поширення навичок (skills) AI-агентів, ми вирішили перезібрати пакет, щоб він став універсальним.
Тому ми презентуємо spatie/guidelines-skills.
Що таке Skills?
Skills — це набори інструкцій багаторазового використання для ШІ-асистентів, які активуються автоматично залежно від контексту. Коли ви працюєте над PHP-файлом, потрібна навичка вмикається сама — не треба щоразу нагадувати ШІ про ваші стандарти. Це постійні, контекстно-залежні правила кодингу для вашого асистента. Вони працюють із Claude Code, Cursor, Codex, GitHub Copilot та багатьма іншими інструментами.
Що входить у пакет
Пакет містить чотири основні навички:
- spatie-laravel-php — наш найповніший набір правил. Охоплює PSR-12, typed properties, constructor promotion, early returns, конвенції маршрутів Laravel, іменування контролерів, правила валідації, Blade-шаблони тощо. Містить детальний довідник з усіх нюансів.
- spatie-javascript — конфігурація Prettier, використання
constза замовчуванням, сувора рівність (strict equality), іменовані функції, деструктуризація та наші стандарти форматування. - spatie-version-control — іменування репозиторіїв, конвенції для гілок, стиль повідомлень комітів та наша стратегія злиття (squash merge для feature-гілок).
- spatie-security — повсюдне використання SSL, захист CSRF, хешування паролів, права доступу до баз даних, server hardening та керування доступами.
Ці навички дублюють правила з spatie.be/guidelines, але адаптовані для ефективної роботи ШІ-асистентів.
Встановлення
Ви можете встановити пакет через Laravel Boost або skills.sh.
Через Laravel Boost
composer require spatie/guidelines-skills --dev
php artisan boost:install
Оберіть гайдлайни Spatie зі списку, і вони встановляться автоматично.
Через skills.sh
npx skills add spatie/guidelines-skills
Це все. Навички активуватимуться автоматично під час роботи з відповідними файлами.
Як оновлюватися
Коли ми оновлюємо гайдлайни, ви можете підтягнути зміни простою командою:
# Composer
composer update spatie/guidelines-skills
php artisan boost:update
# skills.sh
npx skills add spatie/guidelines-skills
Якщо ви використовували spatie/boost-spatie-guidelines, рекомендуємо замінити його на цей пакет — він містить усе те саме, але працює не лише з Boost.
Пакет доступний на GitHub, а повну версію гайдлайнів для читання можна знайти на spatie.be/guidelines.
