Configuration de Prisma ORM

Cette skill gère la sélection de version ORM pour les travaux de setup et de connexion. Préserve la version ORM et la base de données prévue de l'application. Une réparation de connexion ne nécessite pas une mise à jour majeure.

Les nouvelles applications utilisent par défaut Prisma ORM 8. La configuration détaillée de Prisma 8, les requêtes, les migrations et le code runtime appartiennent à la skill prisma-8 versionnée et livrée avec le package ORM.

1. Détecter le point de départ

Lis le manifest des packages, le lockfile, la configuration Prisma, le schéma et les imports de l'application. Identifie la version ORM, le provider de base de données et le runtime. La version CLI seule n'identifie pas la version de l'application : une CLI Prisma 8 peut coexister avec un client legacy, donc inspecte @prisma/client, @prisma/prisma7, et le schéma et la configuration.

Pour une nouvelle application, vérifie le support des providers et les exigences runtime de la version Prisma 8 choisie avant d'installer. Si le provider n'est pas supporté, explique la limitation et propose une version antérieure explicitement choisie. Garde la base de données demandée ; ne bascule pas silencieusement ou n'invente pas une cible supportée.

Utilise une base de données existante quand elle est fournie. Charge prisma-postgres-setup uniquement quand Prisma Postgres est nécessaire et qu'aucune connexion n'a été sélectionnée encore ; reviens ici une fois connecté.

2. Traiter les mises à jour majeures demandées séparément

Quand l'utilisateur demande une mise à jour majeure, charge un workflow qui supporte la version source et le provider. Pour PostgreSQL 7-vers-8, utilise le guide de migration Prisma ; pour MongoDB 6-vers-8, utilise prisma-mongodb-upgrade. Les autres providers ont besoin d'un chemin de migration explicitement supporté. prisma-upgrade-v7 couvre 6 vers 7 ; la référence de mise à jour prisma-8 détenue par le package couvre les mises à jour dans 8.

3. Amorcer une nouvelle application Prisma 8

Vérifie les exigences runtime et le guide d'initialisation de la version choisie. Résous et épingle une version CLI Prisma 8 publiée, en incluant son suffixe de prerelease si nécessaire ; vérifie sa version avant l'initialisation. Ne te fie pas à un latest flottant qui resterait en version 8.

Utilise le gestionnaire de packages du projet pour exécuter la CLI installée. Pour PostgreSQL et l'authoring du langage schéma Prisma :

prisma orm init --yes --target postgres --authoring psl

Utilise la cible supportée pour le provider choisie. Préserve les fichiers d'application existants et la configuration de connexion ; ne laisse pas le setup provisionner une base de données sans rapport. Vérifie que le package ORM résolu est version 8 avant de continuer.

4. Charger les conseils Prisma 8 installés

Exécute la CLI installée via le gestionnaire de packages du projet :

prisma skills sync

Puis lis le prisma-8/SKILL.md synchronisé, par exemple .agents/skills/prisma-8/SKILL.md, et suis ses préconditions et références choisies. La synchronisation seule ne charge pas les instructions. Si les conseils détenus par le package ne peuvent pas être chargés, signale le blocage. Continue à l'étape 6.

5. Configurer ou réparer une version antérieure

Pour un nouveau setup qui sélectionne explicitement une version antérieure, épingle les packages à cette majeure et utilise ses exigences runtime. Garde les versions CLI, client et SQL adapter compatibles. Les dépendances existantes n'ont pas besoin de changer pour une réparation de connexion.

• Prisma 7 SQL : utilise la référence provider ci-dessous et client setup.
• Prisma 6 MongoDB : utilise MongoDB setup. Les adaptateurs de pilote SQL ne s'appliquent pas.
• Prisma 6 SQL : préserve son générateur, l'URL du schéma et l'initialisation du client. Utilise les détails de connexion du provider ci-dessous et la documentation Prisma 6 ; ne copie pas la configuration Prisma 7 ou les exemples d'adapter dans celle-ci.

Les exemples Prisma 7 SQL ont été vérifiés avec Prisma 7.10.0 ; les exemples MongoDB avec Prisma 6.19.3.

6. Connecter et vérifier

La CLI et l'application peuvent charger des fichiers d'environnement différents. Charge l'environnement prévu pour chacun sans afficher les secrets, et garde les credentials dans des fichiers d'environnement ignorés ou la configuration secrète de l'hôte. Pour les adaptateurs SQL, fais en sorte que les options runtime de l'adapter ciblent la même base de données que l'URL de connexion de la CLI.

Pour une app existante, préserve le schéma, les migrations et la configuration du générateur sauf si le travail demandé requiert des changements. Diagnostique la connexion avant d'exécuter des commandes qui modifient le schéma.

Exécute les vérifications pertinentes du projet et une requête en lecture seule via le client de l'application contre la base de données prévue. Signale la version ORM, la version de la skill prisma-8 chargée le cas échéant, et le résultat de la requête. L'installation de package ou une synchronisation de skill réussie seule n'est pas un setup complété.