Linee guida Spatie come competenze AI

Per anni, le nostre linee guida di codifica sono state la spina dorsale di come scriviamo codice in Spatie. Mantengono il nostro codice coerente in ogni progetto e in ogni PR. Quando gli assistenti di codifica AI sono entrati in scena, abbiamo subito capito che questi strumenti dovevano seguire le stesse convenzioni che usiamo noi. Nessuno vuole correggere codice generato dall'AI che usa string|null invece di ?string, o che crea nomi di controller al singolare.

In precedenza avevamo rilasciato spatie/boost-spatie-guidelines, un pacchetto che portava le nostre linee guida in Laravel Boost. Funzionava bene, ma era legato specificamente a Boost. Con l'ascesa di skills.sh come ecosistema aperto per la distribuzione di competenze per agenti AI, abbiamo deciso di ricostruire il pacchetto in modo che funzioni con diversi stack AI.

Ecco perché stiamo rilasciando spatie/guidelines-skills.

Cosa sono le Skills?

Le skills sono set di istruzioni riutilizzabili per assistenti di codifica AI che si attivano automaticamente in base al contesto. Quando lavori su un file PHP, la skill pertinente entra in gioco, senza dover ricordare ogni volta all'AI le tue convenzioni. Pensale come standard di codifica persistenti e sensibili al contesto per il tuo assistente AI. Funzionano con Claude Code, Cursor, Codex, GitHub Copilot e molti altri.

Cosa è incluso

Il pacchetto include quattro skills:

• spatie-laravel-php — La nostra skill più completa. Copre PSR-12, proprietà tipizzate, constructor promotion, early returns, convenzioni per le rotte Laravel, naming dei controller, regole di validazione, template Blade e altro. Include una guida di riferimento dettagliata per i dettagli più fini.
• spatie-javascript — Configurazione Prettier, const di default, uguaglianza stretta, funzioni nominate, destructuring e le nostre regole di formattazione preferite.
• spatie-version-control — Naming dei repository, convenzioni per i branch, stile dei messaggi di commit e la nostra strategia di merge (squash merge sui branch di feature).
• spatie-security — SSL ovunque, protezione CSRF, hashing delle password, permessi del database, hardening del server e gestione delle credenziali.

Questi rispecchiano ciò che trovi su spatie.be/guidelines, distillati in un formato che gli assistenti di codifica AI possono sfruttare.

Installazione

Puoi installare il pacchetto tramite Laravel Boost o skills.sh.

Via Laravel Boost

composer require spatie/guidelines-skills --dev
php artisan boost:install

Seleziona le linee guida Spatie dalla lista e verranno installate automaticamente.

Via skills.sh

npx skills add spatie/guidelines-skills

Ecco fatto. Le skills si attiveranno automaticamente ogni volta che lavori su file pertinenti.

Aggiornamento

Quando aggiorniamo le linee guida, puoi integrare le modifiche con un semplice aggiornamento:

# Composer
composer update spatie/guidelines-skills
php artisan boost:update
# skills.sh
npx skills add spatie/guidelines-skills

Se stavi usando spatie/boost-spatie-guidelines, puoi sostituirlo con questo pacchetto: copre tutto ciò che faceva il vecchio e funziona anche oltre Boost.

Troverai il pacchetto su GitHub e le linee guida complete leggibili dall'uomo su spatie.be/guidelines.