Prisma Driver Adapter Implementation
Ce skill fait partie du repo officiel prisma/skills, une collection de skills destinés aux agents de développement travaillant avec Prisma ORM. Il est conçu pour être installé via npx skills add et mis à disposition automatiquement d'un agent lorsque des tâches liées aux driver adapters sont détectées.
Contenu et objectif
Le SKILL.md est un guide de référence substantiel, non un simple squelette. Il couvre l'ensemble du contrat technique nécessaire pour implémenter un SqlDriverAdapter compatible Prisma v7, en détaillant des informations critiques que le code source seul ne permet pas de déduire : le protocole du cycle de vie des transactions (où commit() et rollback() sont de simples hooks sans émission de SQL), les règles de mapping des arguments et des résultats, la stratégie de conversion vers ColumnTypeEnum, ainsi que la gestion des erreurs via DriverAdapterError et MappedError.
Le skill documente également les interfaces requises (SqlDriverAdapter, Transaction, SqlMigrationAwareDriverAdapterFactory, SqlResultSet, SqlQuery), des exemples de classes de base pour les queryables, les transactions et les factories, ainsi que des notes spécifiques par moteur de base de données (SQLite, PostgreSQL, MySQL/MariaDB).
Quand l'utiliser
Il est recommandé de recourir à ce skill lors de l'implémentation d'un nouvel adapter de driver SQL, de la modification du comportement de SqlDriverAdapter ou Transaction, du câblage d'une factory migration-aware, ou du débogage de problèmes de mapping de types ou de transactions. Le skill inclut également une checklist de vérification et une stratégie de tests unitaires et E2E pour valider qu'une implémentation est complète et correcte.
Installation
Comme tous les skills du repo prisma/skills, il s'installe avec la commande :
npx skills add prisma/skills --skill prisma-driver-adapter-implementation
Une fois installé, il est automatiquement disponible pour l'agent lors des tâches pertinentes. Ce skill cible Prisma ORM v7.6.x.