prisma-driver-adapter-implementation

Skill du repo prisma/skills fournissant un guide complet pour implémenter un driver adapter SQL compatible Prisma ORM v7.

npx skills add https://github.com/prisma/skills --skill prisma-driver-adapter-implementation

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.

Skills similaires