Database migrations

Skill mturac/everything-openai-codex/docs/ja-JP/skills/database-migrations

EOC: open-source operating system for OpenAI Codex workflows with agents, skills, hooks, rules, memory, safety gates, and cross-harness adapters.

Install

npx -y skills add mturac/everything-openai-codex --skill database-migrations

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

PostgreSQL、MySQL、一般的なORM（Prisma、Drizzle、Kysely、Django、TypeORM、golang-migrate）全体のスキーマ変更、データマイグレーション、ロールバック、ゼロダウンタイムデプロイメントのためのデータベースマイグレーションベストプラクティス。

SKILL.md

2.8 KB, as published. Nobody here has run it

データベースマイグレーションパターン

本番環境システム用の安全で可逆的なデータベーススキーマ変更。

アクティベーション時期

データベーステーブルの作成または変更
列またはインデックスの追加/削除
データマイグレーション（バックフィル、変換）の実行
ゼロダウンタイムスキーマ変更を計画
新しいプロジェクト用のマイグレーションツール設定

コア原則

すべての変更はマイグレーション — 本番環境データベースを手動で変更しない
マイグレーションは本番環境で前方のみ — ロールバックは新しい前向きマイグレーション使用
スキーマとデータマイグレーションは分離 — 1つのマイグレーションでDDLとDMLを混ぜない
本番環境サイズのデータに対してマイグレーションをテスト — 100行で機能するマイグレーション10M上でロックされる場合がある
マイグレーションは展開後は不変 — 本番環境で実行されたマイグレーションを編集しない

マイグレーション安全チェックリスト

マイグレーションを適用する前に：

マイグレーションはUPとDOWNの両方を持つ（または明示的に不可逆としてマーク）
大型テーブルの完全テーブルロックなし（並行操作使用）
新しい列はデフォルトまたはnullable（デフォルトなしでNOT NULLを追加しない）
インデックスは並行して作成（既存テーブルのCREATE TABLEでインライン化しない）
データバックフィルはスキーマ変更から分離したマイグレーション
本番環境データのコピーに対してテスト
ロールバック計画を文書化

PostgreSQL パターン

列を安全に追加

-- GOOD: Nullable列、ロックなし
ALTER TABLE users ADD COLUMN avatar_url TEXT;

-- GOOD: デフォルト付きの列（Postgres 11+は即座、書き直しなし）
ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;

-- BAD: 既存テーブルのデフォルトなしで NOT NULL（完全書き直し必須）
ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL;

詳細についてはドキュメントを参照してください。