[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AJWH2M986SVN1TJC949D7F":3,"skill-same:01M7AJWH2M986SVN1TJC949D7F":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AJWH2M986SVN1TJC949D7F","database-migrations",null,"Buenas prácticas de migración de base de datos para cambios de esquema, migraciones de datos, rollbacks y despliegues de tiempo cero en PostgreSQL, MySQL y ORMs comunes (Prisma, Drizzle, Kysely, Django, TypeORM, golang-migrate).","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fes\u002Fskills\u002Fdatabase-migrations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: database-migrations\ndescription: Buenas prácticas de migración de base de datos para cambios de esquema, migraciones de datos, rollbacks y despliegues de tiempo cero en PostgreSQL, MySQL y ORMs comunes (Prisma, Drizzle, Kysely, Django, TypeORM, golang-migrate).\norigin: ECC\n---\n\n# Patrones de Migración de Base de Datos\n\nCambios de esquema de base de datos seguros y reversibles para sistemas de producción.\n\n## Cuándo Activar\n\n- Crear o alterar tablas de base de datos\n- Agregar\u002Feliminar columnas o índices\n- Ejecutar migraciones de datos (backfill, transformación)\n- Planificar cambios de esquema de tiempo cero (zero-downtime)\n- Configurar herramientas de migración para un nuevo proyecto\n\n## Principios Fundamentales\n\n1. **Cada cambio es una migración** — nunca alterar bases de datos de producción manualmente\n2. **Las migraciones son solo hacia adelante en producción** — los rollbacks usan nuevas migraciones hacia adelante\n3. **Las migraciones de esquema y de datos son separadas** — nunca mezclar DDL y DML en una migración\n4. **Probar migraciones contra datos de tamaño de producción** — una migración que funciona en 100 filas puede bloquear en 10M\n5. **Las migraciones son inmutables una vez desplegadas** — nunca editar una migración que ya se ejecutó en producción\n\n## Lista de Verificación de Seguridad de Migración\n\nAntes de aplicar cualquier migración:\n\n- [ ] La migración tiene tanto UP como DOWN (o está marcada explícitamente como irreversible)\n- [ ] Sin bloqueos de tabla completa en tablas grandes (usar operaciones concurrentes)\n- [ ] Las nuevas columnas tienen valores predeterminados o son nullable (nunca agregar NOT NULL sin valor predeterminado)\n- [ ] Índices creados de forma concurrente (no en línea con CREATE TABLE para tablas existentes)\n- [ ] El backfill de datos es una migración separada del cambio de esquema\n- [ ] Probado contra una copia de datos de producción\n- [ ] Plan de rollback documentado\n\n## Patrones PostgreSQL\n\n### Agregar una Columna de Forma Segura\n\n```sql\n-- BIEN: Columna nullable, sin bloqueo\nALTER TABLE users ADD COLUMN avatar_url TEXT;\n\n-- BIEN: Columna con valor predeterminado (Postgres 11+ es instantáneo, sin reescritura)\nALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;\n\n-- MAL: NOT NULL sin valor predeterminado en tabla existente (requiere reescritura completa)\nALTER TABLE users ADD COLUMN role TEXT NOT NULL;\n-- Esto bloquea la tabla y reescribe cada fila\n```\n\n### Agregar un Índice Sin Tiempo de Inactividad\n\n```sql\n-- MAL: Bloquea escrituras en tablas grandes\nCREATE INDEX idx_users_email ON users (email);\n\n-- BIEN: No bloqueante, permite escrituras concurrentes\nCREATE INDEX CONCURRENTLY idx_users_email ON users (email);\n\n-- Nota: CONCURRENTLY no puede ejecutarse dentro de un bloque de transacción\n-- La mayoría de herramientas de migración necesitan manejo especial para esto\n```\n\n### Renombrar una Columna (Zero-Downtime)\n\nNunca renombrar directamente en producción. Usar el patrón expand-contract:\n\n```sql\n-- Paso 1: Agregar nueva columna (migración 001)\nALTER TABLE users ADD COLUMN display_name TEXT;\n\n-- Paso 2: Backfill de datos (migración 002, migración de datos)\nUPDATE users SET display_name = username WHERE display_name IS NULL;\n\n-- Paso 3: Actualizar el código de la aplicación para leer\u002Fescribir ambas columnas\n-- Desplegar cambios de aplicación\n\n-- Paso 4: Dejar de escribir en la columna antigua, eliminarla (migración 003)\nALTER TABLE users DROP COLUMN username;\n```\n\n### Eliminar una Columna de Forma Segura\n\n```sql\n-- Paso 1: Eliminar todas las referencias de la aplicación a la columna\n-- Paso 2: Desplegar la aplicación sin la referencia a la columna\n-- Paso 3: Eliminar la columna en la próxima migración\nALTER TABLE orders DROP COLUMN legacy_status;\n\n-- Para Django: usar SeparateDatabaseAndState para eliminar del modelo\n-- sin generar DROP COLUMN (luego eliminar en la próxima migración)\n```\n\n### Migraciones de Datos Grandes\n\n```sql\n-- MAL: Actualiza todas las filas en una transacción (bloquea la tabla)\nUPDATE users SET normalized_email = LOWER(email);\n\n-- BIEN: Actualización en lotes con progreso\nDO $$\nDECLARE\n  batch_size INT := 10000;\n  rows_updated INT;\nBEGIN\n  LOOP\n    UPDATE users\n    SET normalized_email = LOWER(email)\n    WHERE id IN (\n      SELECT id FROM users\n      WHERE normalized_email IS NULL\n      LIMIT batch_size\n      FOR UPDATE SKIP LOCKED\n    );\n    GET DIAGNOSTICS rows_updated = ROW_COUNT;\n    RAISE NOTICE 'Updated % rows', rows_updated;\n    EXIT WHEN rows_updated = 0;\n    COMMIT;\n  END LOOP;\nEND $$;\n```\n\n## Prisma (TypeScript\u002FNode.js)\n\n### Flujo de Trabajo\n\n```bash\n# Crear migración a partir de cambios de esquema\nnpx prisma migrate dev --name add_user_avatar\n\n# Aplicar migraciones pendientes en producción\nnpx prisma migrate deploy\n\n# Resetear base de datos (solo desarrollo)\nnpx prisma migrate reset\n\n# Generar cliente después de cambios de esquema\nnpx prisma generate\n```\n\n### Ejemplo de Esquema\n\n```prisma\nmodel User {\n  id        String   @id @default(cuid())\n  email     String   @unique\n  name      String?\n  avatarUrl String?  @map(\"avatar_url\")\n  createdAt DateTime @default(now()) @map(\"created_at\")\n  updatedAt DateTime @updatedAt @map(\"updated_at\")\n  orders    Order[]\n\n  @@map(\"users\")\n  @@index([email])\n}\n```\n\n### Migración SQL Personalizada\n\nPara operaciones que Prisma no puede expresar (índices concurrentes, backfills de datos):\n\n```bash\n# Crear migración vacía, luego editar el SQL manualmente\nnpx prisma migrate dev --create-only --name add_email_index\n```\n\n```sql\n-- migrations\u002F20240115_add_email_index\u002Fmigration.sql\n-- Prisma no puede generar CONCURRENTLY, por lo que se escribe manualmente\nCREATE INDEX CONCURRENTLY IF NOT EXISTS idx_users_email ON users (email);\n```\n\n## Drizzle (TypeScript\u002FNode.js)\n\n### Flujo de Trabajo\n\n```bash\n# Generar migración a partir de cambios de esquema\nnpx drizzle-kit generate\n\n# Aplicar migraciones\nnpx drizzle-kit migrate\n\n# Hacer push del esquema directamente (solo desarrollo, sin archivo de migración)\nnpx drizzle-kit push\n```\n\n### Ejemplo de Esquema\n\n```typescript\nimport { pgTable, text, timestamp, uuid, boolean } from \"drizzle-orm\u002Fpg-core\";\n\nexport const users = pgTable(\"users\", {\n  id: uuid(\"id\").primaryKey().defaultRandom(),\n  email: text(\"email\").notNull().unique(),\n  name: text(\"name\"),\n  isActive: boolean(\"is_active\").notNull().default(true),\n  createdAt: timestamp(\"created_at\").notNull().defaultNow(),\n  updatedAt: timestamp(\"updated_at\").notNull().defaultNow(),\n});\n```\n\n## Kysely (TypeScript\u002FNode.js)\n\n### Flujo de Trabajo (kysely-ctl)\n\n```bash\n# Inicializar archivo de configuración (kysely.config.ts)\nkysely init\n\n# Crear un nuevo archivo de migración\nkysely migrate make add_user_avatar\n\n# Aplicar todas las migraciones pendientes\nkysely migrate latest\n\n# Revertir la última migración\nkysely migrate down\n\n# Mostrar estado de migraciones\nkysely migrate list\n```\n\n### Archivo de Migración\n\n```typescript\n\u002F\u002F migrations\u002F2024_01_15_001_create_user_profile.ts\nimport { type Kysely, sql } from 'kysely'\n\n\u002F\u002F IMPORTANTE: Siempre usar Kysely\u003Cany>, no tu interfaz de DB tipada.\n\u002F\u002F Las migraciones están congeladas en el tiempo y no deben depender de los tipos de esquema actuales.\nexport async function up(db: Kysely\u003Cany>): Promise\u003Cvoid> {\n  await db.schema\n    .createTable('user_profile')\n    .addColumn('id', 'serial', (col) => col.primaryKey())\n    .addColumn('email', 'varchar(255)', (col) => col.notNull().unique())\n    .addColumn('avatar_url', 'text')\n    .addColumn('created_at', 'timestamp', (col) =>\n      col.defaultTo(sql`now()`).notNull()\n    )\n    .execute()\n\n  await db.schema\n    .createIndex('idx_user_profile_avatar')\n    .on('user_profile')\n    .column('avatar_url')\n    .execute()\n}\n\nexport async function down(db: Kysely\u003Cany>): Promise\u003Cvoid> {\n  await db.schema.dropTable('user_profile').execute()\n}\n```\n\n### Migrador Programático\n\n```typescript\nimport { Migrator, FileMigrationProvider } from 'kysely'\nimport { promises as fs } from 'fs'\nimport * as path from 'path'\n\u002F\u002F Solo ESM — CJS puede usar __dirname directamente\nimport { fileURLToPath } from 'url'\nconst migrationFolder = path.join(\n  path.dirname(fileURLToPath(import.meta.url)),\n  '.\u002Fmigrations',\n)\n\n\u002F\u002F `db` es tu instancia de base de datos Kysely\u003Cany>\nconst migrator = new Migrator({\n  db,\n  provider: new FileMigrationProvider({\n    fs,\n    path,\n    migrationFolder,\n  }),\n  \u002F\u002F ADVERTENCIA: Solo habilitar en desarrollo. Deshabilita la validación de\n  \u002F\u002F ordenamiento por timestamp, lo que puede causar deriva de esquema entre entornos.\n  \u002F\u002F allowUnorderedMigrations: true,\n})\n\nconst { error, results } = await migrator.migrateToLatest()\n\nresults?.forEach((it) => {\n  if (it.status === 'Success') {\n    console.log(`migration \"${it.migrationName}\" executed successfully`)\n  } else if (it.status === 'Error') {\n    console.error(`failed to execute migration \"${it.migrationName}\"`)\n  }\n})\n\nif (error) {\n  console.error('migration failed', error)\n  process.exit(1)\n}\n```\n\n## Django (Python)\n\n### Flujo de Trabajo\n\n```bash\n# Generar migración a partir de cambios de modelo\npython manage.py makemigrations\n\n# Aplicar migraciones\npython manage.py migrate\n\n# Mostrar estado de migraciones\npython manage.py showmigrations\n\n# Generar migración vacía para SQL personalizado\npython manage.py makemigrations --empty app_name -n description\n```\n\n### Migración de Datos\n\n```python\nfrom django.db import migrations\n\ndef backfill_display_names(apps, schema_editor):\n    User = apps.get_model(\"accounts\", \"User\")\n    batch_size = 5000\n    users = User.objects.filter(display_name=\"\")\n    while users.exists():\n        batch = list(users[:batch_size])\n        for user in batch:\n            user.display_name = user.username\n        User.objects.bulk_update(batch, [\"display_name\"], batch_size=batch_size)\n\ndef reverse_backfill(apps, schema_editor):\n    pass  # Migración de datos, no se necesita reversión\n\nclass Migration(migrations.Migration):\n    dependencies = [(\"accounts\", \"0015_add_display_name\")]\n\n    operations = [\n        migrations.RunPython(backfill_display_names, reverse_backfill),\n    ]\n```\n\n### SeparateDatabaseAndState\n\nEliminar una columna del modelo Django sin eliminarla de la base de datos inmediatamente:\n\n```python\nclass Migration(migrations.Migration):\n    operations = [\n        migrations.SeparateDatabaseAndState(\n            state_operations=[\n                migrations.RemoveField(model_name=\"user\", name=\"legacy_field\"),\n            ],\n            database_operations=[],  # No tocar la DB todavía\n        ),\n    ]\n```\n\n## golang-migrate (Go)\n\n### Flujo de Trabajo\n\n```bash\n# Crear par de migración\nmigrate create -ext sql -dir migrations -seq add_user_avatar\n\n# Aplicar todas las migraciones pendientes\nmigrate -path migrations -database \"$DATABASE_URL\" up\n\n# Revertir la última migración\nmigrate -path migrations -database \"$DATABASE_URL\" down 1\n\n# Forzar versión (corregir estado sucio)\nmigrate -path migrations -database \"$DATABASE_URL\" force VERSION\n```\n\n### Archivos de Migración\n\n```sql\n-- migrations\u002F000003_add_user_avatar.up.sql\nALTER TABLE users ADD COLUMN avatar_url TEXT;\nCREATE INDEX CONCURRENTLY idx_users_avatar ON users (avatar_url) WHERE avatar_url IS NOT NULL;\n\n-- migrations\u002F000003_add_user_avatar.down.sql\nDROP INDEX IF EXISTS idx_users_avatar;\nALTER TABLE users DROP COLUMN IF EXISTS avatar_url;\n```\n\n## Estrategia de Migración de Zero-Downtime\n\nPara cambios críticos de producción, seguir el patrón expand-contract:\n\n```\nFase 1: EXPAND (Expandir)\n  - Agregar nueva columna\u002Ftabla (nullable o con valor predeterminado)\n  - Desplegar: la app escribe en AMBAS, vieja y nueva\n  - Backfill de datos existentes\n\nFase 2: MIGRATE (Migrar)\n  - Desplegar: la app lee de la NUEVA, escribe en AMBAS\n  - Verificar consistencia de datos\n\nFase 3: CONTRACT (Contraer)\n  - Desplegar: la app solo usa la NUEVA\n  - Eliminar columna\u002Ftabla antigua en migración separada\n```\n\n### Ejemplo de Línea de Tiempo\n\n```\nDía 1: Migración agrega columna new_status (nullable)\nDía 1: Desplegar app v2 — escribe en status y new_status\nDía 2: Ejecutar migración de backfill para filas existentes\nDía 3: Desplegar app v3 — lee solo de new_status\nDía 7: Migración elimina columna status antigua\n```\n\n## Anti-Patrones\n\n| Anti-Patrón | Por Qué Falla | Mejor Enfoque |\n|-------------|-------------|-----------------|\n| SQL manual en producción | Sin historial de auditoría, no repetible | Siempre usar archivos de migración |\n| Editar migraciones desplegadas | Causa deriva entre entornos | Crear nueva migración en su lugar |\n| NOT NULL sin valor predeterminado | Bloquea tabla, reescribe todas las filas | Agregar nullable, backfill, luego agregar restricción |\n| Índice en línea en tabla grande | Bloquea escrituras durante la construcción | CREATE INDEX CONCURRENTLY |\n| Esquema + datos en una migración | Difícil de revertir, transacciones largas | Migraciones separadas |\n| Eliminar columna antes de eliminar código | Errores de aplicación por columna faltante | Eliminar código primero, eliminar columna en el próximo despliegue |\n","# Patrones de Migración de Base de Datos\n\nCambios de esquema de base de datos seguros y reversibles para sistemas de producción.\n\n## Cuándo Activar\n\n- Crear o alterar tablas de base de datos\n- Agregar\u002Feliminar columnas o índices\n- Ejecutar migraciones de datos (backfill, transformación)\n- Planificar cambios de esquema de tiempo cero (zero-downtime)\n- Configurar herramientas de migración para un nuevo proyecto\n\n## Principios Fundamentales\n\n1. **Cada cambio es una migración** — nunca alterar bases de datos de producción manualmente\n2. **Las migraciones son solo hacia adelante en producción** — los rollbacks usan nuevas migraciones hacia adelante\n3. **Las migraciones de esquema y de datos son separadas** — nunca mezclar DDL y DML en una migración\n4. **Probar migraciones contra datos de tamaño de producción** — una migración que funciona en 100 filas puede bloquear en 10M\n5. **Las migraciones son inmutables una vez desplegadas** — nunca editar una migración que ya se ejecutó en producción\n\n## Lista de Verificación de Seguridad de Migración\n\nAntes de aplicar cualquier migración:\n\n- [ ] La migración tiene tanto UP como DOWN (o está marcada explícitamente como irreversible)\n- [ ] Sin bloqueos de tabla completa en tablas grandes (usar operaciones concurrentes)\n- [ ] Las nuevas columnas tienen valores predeterminados o son nullable (nunca agregar NOT NULL sin valor predeterminado)\n- [ ] Índices creados de forma concurrente (no en línea con CREATE TABLE para tablas existentes)\n- [ ] El backfill de datos es una migración separada del cambio de esquema\n- [ ] Probado contra una copia de datos de producción\n- [ ] Plan de rollback documentado\n\n## Patrones PostgreSQL\n\n### Agregar una Columna de Forma Segura\n\n```sql\n-- BIEN: Columna nullable, sin bloqueo\nALTER TABLE users ADD COLUMN avatar_url TEXT;\n\n-- BIEN: Columna con valor predeterminado (Postgres 11+ es instantáneo, sin reescritura)\nALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;\n\n-- MAL: NOT NULL sin valor predeterminado en tabla existente (requiere reescritura completa)\nALTER TABLE users ADD COLUMN role TEXT NOT NULL;\n-- Esto bloquea la tabla y reescribe cada fila\n```\n\n### Agregar un Índice Sin Tiempo de Inactividad\n\n```sql\n-- MAL: Bloquea escrituras en tablas grandes\nCREATE INDEX idx_users_email ON users (email);\n\n-- BIEN: No bloqueante, permite escrituras concurrentes\nCREATE INDEX CONCURRENTLY idx_users_email ON users (email);\n\n-- Nota: CONCURRENTLY no puede ejecutarse dentro de un bloque de transacción\n-- La mayoría de herramientas de migración necesitan manejo especial para esto\n```\n\n### Renombrar una Columna (Zero-Downtime)\n\nNunca renombrar directamente en producción. Usar el patrón expand-contract:\n\n```sql\n-- Paso 1: Agregar nueva columna (migración 001)\nALTER TABLE users ADD COLUMN display_name TEXT;\n\n-- Paso 2: Backfill de datos (migración 002, migración de datos)\nUPDATE users SET display_name = username WHERE display_name IS NULL;\n\n-- Paso 3: Actualizar el código de la aplicación para leer\u002Fescribir ambas columnas\n-- Desplegar cambios de aplicación\n\n-- Paso 4: Dejar de escribir en la columna antigua, eliminarla (migración 003)\nALTER TABLE users DROP COLUMN username;\n```\n\n### Eliminar una Columna de Forma Segura\n\n```sql\n-- Paso 1: Eliminar todas las referencias de la aplicación a la columna\n-- Paso 2: Desplegar la aplicación sin la referencia a la columna\n-- Paso 3: Eliminar la columna en la próxima migración\nALTER TABLE orders DROP COLUMN legacy_status;\n\n-- Para Django: usar SeparateDatabaseAndState para eliminar del modelo\n-- sin generar DROP COLUMN (luego eliminar en la próxima migración)\n```\n\n### Migraciones de Datos Grandes\n\n```sql\n-- MAL: Actualiza todas las filas en una transacción (bloquea la tabla)\nUPDATE users SET normalized_email = LOWER(email);\n\n-- BIEN: Actualización en lotes con progreso\nDO $$\nDECLARE\n  batch_size INT := 10000;\n  rows_updated INT;\nBEGIN\n  LOOP\n    UPDATE users\n    SET normalized_email = LOWER(email)\n    WHERE id IN (\n      SELECT id FROM users\n      WHERE normalized_email IS NULL\n      LIMIT batch_size\n      FOR UPDATE SKIP LOCKED\n    );\n    GET DIAGNOSTICS rows_updated = ROW_COUNT;\n    RAISE NOTICE 'Updated % rows', rows_updated;\n    EXIT WHEN rows_updated = 0;\n    COMMIT;\n  END LOOP;\nEND $$;\n```\n\n## Prisma (TypeScript\u002FNode.js)\n\n### Flujo de Trabajo\n\n```bash\n# Crear migración a partir de cambios de esquema\nnpx prisma migrate dev --name add_user_avatar\n\n# Aplicar migraciones pendientes en producción\nnpx prisma migrate deploy\n\n# Resetear base de datos (solo desarrollo)\nnpx prisma migrate reset\n\n# Generar cliente después de cambios de esquema\nnpx prisma generate\n```\n\n### Ejemplo de Esquema\n\n```prisma\nmodel User {\n  id        String   @id @default(cuid())\n  email     String   @unique\n  name      String?\n  avatarUrl String?  @map(\"avatar_url\")\n  createdAt DateTime @default(now()) @map(\"created_at\")\n  updatedAt DateTime @updatedAt @map(\"updated_at\")\n  orders    Order[]\n\n  @@map(\"users\")\n  @@index([email])\n}\n```\n\n### Migración SQL Personalizada\n\nPara operaciones que Prisma no puede expresar (índices concurrentes, backfills de datos):\n\n```bash\n# Crear migración vacía, luego editar el SQL manualmente\nnpx prisma migrate dev --create-only --name add_email_index\n```\n\n```sql\n-- migrations\u002F20240115_add_email_index\u002Fmigration.sql\n-- Prisma no puede generar CONCURRENTLY, por lo que se escribe manualmente\nCREATE INDEX CONCURRENTLY IF NOT EXISTS idx_users_email ON users (email);\n```\n\n## Drizzle (TypeScript\u002FNode.js)\n\n### Flujo de Trabajo\n\n```bash\n# Generar migración a partir de cambios de esquema\nnpx drizzle-kit generate\n\n# Aplicar migraciones\nnpx drizzle-kit migrate\n\n# Hacer push del esquema directamente (solo desarrollo, sin archivo de migración)\nnpx drizzle-kit push\n```\n\n### Ejemplo de Esquema\n\n```typescript\nimport { pgTable, text, timestamp, uuid, boolean } from \"drizzle-orm\u002Fpg-core\";\n\nexport const users = pgTable(\"users\", {\n  id: uuid(\"id\").primaryKey().defaultRandom(),\n  email: text(\"email\").notNull().unique(),\n  name: text(\"name\"),\n  isActive: boolean(\"is_active\").notNull().default(true),\n  createdAt: timestamp(\"created_at\").notNull().defaultNow(),\n  updatedAt: timestamp(\"updated_at\").notNull().defaultNow(),\n});\n```\n\n## Kysely (TypeScript\u002FNode.js)\n\n### Flujo de Trabajo (kysely-ctl)\n\n```bash\n# Inicializar archivo de configuración (kysely.config.ts)\nkysely init\n\n# Crear un nuevo archivo de migración\nkysely migrate make add_user_avatar\n\n# Aplicar todas las migraciones pendientes\nkysely migrate latest\n\n# Revertir la última migración\nkysely migrate down\n\n# Mostrar estado de migraciones\nkysely migrate list\n```\n\n### Archivo de Migración\n\n```typescript\n\u002F\u002F migrations\u002F2024_01_15_001_create_user_profile.ts\nimport { type Kysely, sql } from 'kysely'\n\n\u002F\u002F IMPORTANTE: Siempre usar Kysely\u003Cany>, no tu interfaz de DB tipada.\n\u002F\u002F Las migraciones están congeladas en el tiempo y no deben depender de los tipos de esquema actuales.\nexport async function up(db: Kysely\u003Cany>): Promise\u003Cvoid> {\n  await db.schema\n    .createTable('user_profile')\n    .addColumn('id', 'serial', (col) => col.primaryKey())\n    .addColumn('email', 'varchar(255)', (col) => col.notNull().unique())\n    .addColumn('avatar_url', 'text')\n    .addColumn('created_at', 'timestamp', (col) =>\n      col.defaultTo(sql`now()`).notNull()\n    )\n    .execute()\n\n  await db.schema\n    .createIndex('idx_user_profile_avatar')\n    .on('user_profile')\n    .column('avatar_url')\n    .execute()\n}\n\nexport async function down(db: Kysely\u003Cany>): Promise\u003Cvoid> {\n  await db.schema.dropTable('user_profile').execute()\n}\n```\n\n### Migrador Programático\n\n```typescript\nimport { Migrator, FileMigrationProvider } from 'kysely'\nimport { promises as fs } from 'fs'\nimport * as path from 'path'\n\u002F\u002F Solo ESM — CJS puede usar __dirname directamente\nimport { fileURLToPath } from 'url'\nconst migrationFolder = path.join(\n  path.dirname(fileURLToPath(import.meta.url)),\n  '.\u002Fmigrations',\n)\n\n\u002F\u002F `db` es tu instancia de base de datos Kysely\u003Cany>\nconst migrator = new Migrator({\n  db,\n  provider: new FileMigrationProvider({\n    fs,\n    path,\n    migrationFolder,\n  }),\n  \u002F\u002F ADVERTENCIA: Solo habilitar en desarrollo. Deshabilita la validación de\n  \u002F\u002F ordenamiento por timestamp, lo que puede causar deriva de esquema entre entornos.\n  \u002F\u002F allowUnorderedMigrations: true,\n})\n\nconst { error, results } = await migrator.migrateToLatest()\n\nresults?.forEach((it) => {\n  if (it.status === 'Success') {\n    console.log(`migration \"${it.migrationName}\" executed successfully`)\n  } else if (it.status === 'Error') {\n    console.error(`failed to execute migration \"${it.migrationName}\"`)\n  }\n})\n\nif (error) {\n  console.error('migration failed', error)\n  process.exit(1)\n}\n```\n\n## Django (Python)\n\n### Flujo de Trabajo\n\n```bash\n# Generar migración a partir de cambios de modelo\npython manage.py makemigrations\n\n# Aplicar migraciones\npython manage.py migrate\n\n# Mostrar estado de migraciones\npython manage.py showmigrations\n\n# Generar migración vacía para SQL personalizado\npython manage.py makemigrations --empty app_name -n description\n```\n\n### Migración de Datos\n\n```python\nfrom django.db import migrations\n\ndef backfill_display_names(apps, schema_editor):\n    User = apps.get_model(\"accounts\", \"User\")\n    batch_size = 5000\n    users = User.objects.filter(display_name=\"\")\n    while users.exists():\n        batch = list(users[:batch_size])\n        for user in batch:\n            user.display_name = user.username\n        User.objects.bulk_update(batch, [\"display_name\"], batch_size=batch_size)\n\ndef reverse_backfill(apps, schema_editor):\n    pass  # Migración de datos, no se necesita reversión\n\nclass Migration(migrations.Migration):\n    dependencies = [(\"accounts\", \"0015_add_display_name\")]\n\n    operations = [\n        migrations.RunPython(backfill_display_names, reverse_backfill),\n    ]\n```\n\n### SeparateDatabaseAndState\n\nEliminar una columna del modelo Django sin eliminarla de la base de datos inmediatamente:\n\n```python\nclass Migration(migrations.Migration):\n    operations = [\n        migrations.SeparateDatabaseAndState(\n            state_operations=[\n                migrations.RemoveField(model_name=\"user\", name=\"legacy_field\"),\n            ],\n            database_operations=[],  # No tocar la DB todavía\n        ),\n    ]\n```\n\n## golang-migrate (Go)\n\n### Flujo de Trabajo\n\n```bash\n# Crear par de migración\nmigrate create -ext sql -dir migrations -seq add_user_avatar\n\n# Aplicar todas las migraciones pendientes\nmigrate -path migrations -database \"$DATABASE_URL\" up\n\n# Revertir la última migración\nmigrate -path migrations -database \"$DATABASE_URL\" down 1\n\n# Forzar versión (corregir estado sucio)\nmigrate -path migrations -database \"$DATABASE_URL\" force VERSION\n```\n\n### Archivos de Migración\n\n```sql\n-- migrations\u002F000003_add_user_avatar.up.sql\nALTER TABLE users ADD COLUMN avatar_url TEXT;\nCREATE INDEX CONCURRENTLY idx_users_avatar ON users (avatar_url) WHERE avatar_url IS NOT NULL;\n\n-- migrations\u002F000003_add_user_avatar.down.sql\nDROP INDEX IF EXISTS idx_users_avatar;\nALTER TABLE users DROP COLUMN IF EXISTS avatar_url;\n```\n\n## Estrategia de Migración de Zero-Downtime\n\nPara cambios críticos de producción, seguir el patrón expand-contract:\n\n```\nFase 1: EXPAND (Expandir)\n  - Agregar nueva columna\u002Ftabla (nullable o con valor predeterminado)\n  - Desplegar: la app escribe en AMBAS, vieja y nueva\n  - Backfill de datos existentes\n\nFase 2: MIGRATE (Migrar)\n  - Desplegar: la app lee de la NUEVA, escribe en AMBAS\n  - Verificar consistencia de datos\n\nFase 3: CONTRACT (Contraer)\n  - Desplegar: la app solo usa la NUEVA\n  - Eliminar columna\u002Ftabla antigua en migración separada\n```\n\n### Ejemplo de Línea de Tiempo\n\n```\nDía 1: Migración agrega columna new_status (nullable)\nDía 1: Desplegar app v2 — escribe en status y new_status\nDía 2: Ejecutar migración de backfill para filas existentes\nDía 3: Desplegar app v3 — lee solo de new_status\nDía 7: Migración elimina columna status antigua\n```\n\n## Anti-Patrones\n\n| Anti-Patrón | Por Qué Falla | Mejor Enfoque |\n|-------------|-------------|-----------------|\n| SQL manual en producción | Sin historial de auditoría, no repetible | Siempre usar archivos de migración |\n| Editar migraciones desplegadas | Causa deriva entre entornos | Crear nueva migración en su lugar |\n| NOT NULL sin valor predeterminado | Bloquea tabla, reescribe todas las filas | Agregar nullable, backfill, luego agregar restricción |\n| Índice en línea en tabla grande | Bloquea escrituras durante la construcción | CREATE INDEX CONCURRENTLY |\n| Esquema + datos en una migración | Difícil de revertir, transacciones largas | Migraciones separadas |\n| Eliminar columna antes de eliminar código | Errores de aplicación por columna faltante | Eliminar código primero, eliminar columna en el próximo despliegue |\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fes\u002Fskills\u002Fdatabase-migrations",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill database-migrations",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill database-migrations",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill database-migrations","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fes\u002Fskills\u002Fdatabase-migrations\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]