Communitygithub.com

Aide aux Migrations de Base de Données

Crée des fichiers de migration de base de données conformes aux conventions de projet pour Prisma, Sequelize, Alembic, Knex, TypeORM et autres ORM. À utiliser lors de l'ajout de tables, de modifications de schémas, ou lorsque l'utilisateur mentionne des changements de base de données.

Qu'est-ce que Aide aux Migrations de Base de Données ?

Cette compétence (skill) assiste les développeurs dans la génération de fichiers de migration de base de données en respectant les conventions et styles spécifiques à l'ORM (Object-Relational Mapping) utilisé dans le projet. Elle prend en charge les ORM et outils de migration les plus courants, notamment Prisma, Sequelize, Knex, TypeORM, Alembic (Python), Django, Active Record (Rails), Flyway et Liquibase. La compétence fonctionne en trois étapes principales : détection automatique de l'ORM via la recherche de fichiers indicateurs (schéma Prisma, knexfile.js, alembic.ini, etc.), analyse des migrations existantes pour comprendre les conventions de nommage et les formats de fichiers, puis génération du fichier de migration approprié avec les commandes adaptées. Elle fournit également des lignes directrices pour garantir la sécurité des migrations (vérification de la réversibilité, prévention des pertes de données, gestion des dépendances) et propose des bonnes pratiques telles que l'utilisation de transactions, la décomposition des changements complexes, et les tests en environnement de développement avant le déploiement en production. Cette compétence est particulièrement utile dans les environnements de développement collaboratif où la cohérence des migrations entre les membres de l'équipe est cruciale.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/crazydubya/database-migration-helper

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Aide aux Migrations de Base de Données ?

Cette compétence vous aide à créer des fichiers de migration de base de données qui suivent les conventions et les modèles de nommage de votre projet.

Quand Utiliser Cette Compétence

  • L'utilisateur demande la création d'une migration de base de données
  • Ajout de nouvelles tables ou colonnes à la base de données
  • Modification du schéma de base de données existant
  • Création d'index, de contraintes ou de relations
  • L'utilisateur mentionne « migration », « changement de schéma » ou « mise à jour de la base de données »

Instructions

1. Détecter l'ORM/Outil de Migration

Identifiez d'abord quel ORM ou outil de migration le projet utilise :

  • Prisma : Recherchez prisma/schema.prisma ou @prisma/client dans package.json
  • Sequelize : Recherchez .sequelizerc ou sequelize-cli dans package.json
  • Knex : Recherchez knexfile.js ou knex dans package.json
  • TypeORM : Recherchez ormconfig.json ou typeorm dans package.json
  • Alembic (Python) : Recherchez alembic.ini ou le répertoire alembic/
  • Django : Recherchez manage.py et les migrations Django dans */migrations/
  • Active Record (Rails) : Recherchez le répertoire db/migrate/
  • Flyway : Recherchez flyway.conf ou db/migration/
  • Liquibase : Recherchez liquibase.properties ou des fichiers changelog

Utilisez Glob pour rechercher ces fichiers indicateurs.

2. Examiner les Migrations Existantes

Lisez les fichiers de migration existants pour comprendre :

  • Les conventions de nommage (format du timestamp, format de la description)
  • La structure des répertoires
  • Le format des fichiers de migration (SQL, JavaScript, TypeScript, Python, etc.)
  • Les modèles de codage (fonctions up/down, forward/rollback, etc.)

Utilisez Grep pour trouver les migrations récentes : regardez dans les répertoires courants comme :

  • prisma/migrations/
  • db/migrate/
  • migrations/ ou database/migrations/
  • alembic/versions/

3. Générer le Fichier de Migration

En fonction de l'ORM détecté, créez un fichier de migration approprié :

Prisma

  • Exécutez npx prisma migrate dev --name <description> OU
  • Créez manuellement le SQL de migration dans prisma/migrations/<timestamp>_<name>/migration.sql

Sequelize

  • Générez : npx sequelize-cli migration:generate --name <description>
  • Remplissez ensuite les fonctions up/down avec les modifications de schéma

Knex

  • Générez : npx knex migrate:make <description>
  • Remplissez les fonctions exports.up et exports.down

TypeORM

  • Générez : npm run typeorm migration:create src/migrations/<Nom>
  • Implémentez les méthodes up() et down()

Alembic

  • Générez : alembic revision -m "<description>"
  • Remplissez les fonctions upgrade() et downgrade()

Django

  • Exécutez : python manage.py makemigrations
  • Ou créez manuellement la migration dans <app>/migrations/

Rails

  • Générez : rails generate migration <NomDeClasse>
  • Remplissez la méthode change (ou up/down pour les migrations complexes)

4. Suivre les Conventions de Nommage

Utilisez des noms cohérents et descriptifs :

  • Bien : add_user_email_index, create_products_table, add_payment_status_to_orders
  • Mal : migration1, update, fix

Formatez selon les modèles du projet :

  • Préfixe temporel : 20231215120000_add_email_to_users
  • Séquentiel : 001_create_users, 002_add_indexes

5. Inclure les Opérations Montée et Descente/Rollback

Fournissez toujours les deux directions lorsque c'est possible :

  • Up/Upgrade/Forward : Appliquez la modification de schéma
  • Down/Downgrade/Rollback : Annulez la modification de schéma

Pour les ORM qui utilisent des opérations réversibles (Rails, certains Sequelize), une seule méthode change peut suffire.

6. Directives pour le Contenu de la Migration

Création de Tables :

  • Définissez toutes les colonnes avec des types appropriés
  • Définissez les contraintes NOT NULL là où c'est approprié
  • Ajoutez des clés primaires
  • Incluez les timestamps (created_at, updated_at) si le projet les utilise
  • Ajoutez les clés étrangères et les index dans la même migration ou séparément selon les préférences du projet

Modification de Tables :

  • Soyez précis : ADD COLUMN, DROP COLUMN, MODIFY COLUMN
  • Gérez les données existantes de manière appropriée (valeurs par défaut, remplissage)
  • Tenez compte de la rétrocompatibilité

Ajout d'Index :

  • Nommez les index clairement : idx_users_email, idx_orders_user_id_created_at
  • Utilisez les types d'index appropriés (B-tree, Hash, GIN, etc.)
  • Envisagez des index partiels pour les grandes tables

Migrations de Données :

  • Séparez les migrations de schéma des migrations de données si possible
  • Soyez prudent avec les grands ensembles de données (opérations par lots)
  • Testez le rollback avec des volumes de données réalistes

7. Valider la Sécurité de la Migration

Avant de finaliser, vérifiez :

  • Réversibilité : La migration peut-elle être annulée ?
  • Perte de données : Des données seront-elles perdues ? Prévenez l'utilisateur !
  • Temps d'arrêt : Cela verrouillera-t-il des tables ? Envisagez des migrations en ligne pour les grandes tables
  • Dépendances : Y a-t-il des migrations dépendantes qui doivent s'exécuter en premier ?

8. Recommandations de Test

Suggérez à l'utilisateur :

  • Exécutez d'abord la migration sur une base de données de développement
  • Testez la fonctionnalité de rollback
  • Pour la production : testez sur un environnement de staging
  • Passez en revue le SQL généré (pour les ORM qui génèrent automatiquement)

Modèles Spécifiques à l'ORM

Consultez les modèles dans le répertoire templates/ :

  • prisma-migration.sql - Exemple de migration Prisma
  • sequelize-migration.js - Exemple de migration Sequelize
  • knex-migration.js - Exemple de migration Knex
  • typeorm-migration.ts - Exemple de migration TypeORM
  • alembic-migration.py - Exemple de migration Alembic
  • rails-migration.rb - Exemple de migration Rails

Bonnes Pratiques

  1. Un seul objectif par migration : Ne mélangez pas des modifications sans rapport
  2. Noms descriptifs : Les noms doivent expliquer ce que fait la migration
  3. Horodatage : Utilisez le format d'horodatage de l'ORM pour l'ordre
  4. Idempotent si possible : Sans danger à exécuter plusieurs fois
  5. Testez les rollbacks : Assurez-vous que le down/rollback fonctionne correctement
  6. Documentez la logique complexe : Ajoutez des commentaires pour les opérations non évidentes
  7. Traitez les grandes opérations par lots : Pour les migrations de données affectant de nombreuses lignes
  8. Utilisez des transactions : Enveloppez les opérations dans des transactions lorsque c'est possible

Fichiers d'Accompagnement

  • templates/ : Modèles de migration pour divers ORM
  • reference.md : Conventions de nommage et modèles de migration

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés