database-migrations SKILL.md skillA

database-migrations from affaan-m/ecc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add affaan-m/ecc/database-migrations@git:20260517.ec9ace9

Pins git:20260517.ec9ace9 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

affaan-m/ecc

Path

docs/ja-JP/skills/database-migrations/SKILL.md

Versions recorded

1

Latest version

git:20260517.ec9ace9, committed May 17, 2026

Size

2,852 bytes

Repository stars

293,827

License

MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

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

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

## アクティベーション時期

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

## コア原則

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

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

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

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

## PostgreSQL パターン

### 列を安全に追加

```sql
-- 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;
```

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

Read the whole file at its exact version.

How to install

mdr add affaan-m/ecc/database-migrations@sha256:911936caa39233d3

[![mdr](https://markdownregistry.com/badge/art_eaoxqn42zhcqk34o.svg)](https://markdownregistry.com/a/art_eaoxqn42zhcqk34o)

Versions

The registry has recorded 1 version of this file, committed on May 17, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_eaoxqn42zhcqk34o
GET https://markdownregistry.com/api/v1/resolve?ref=affaan-m/ecc/database-migrations
GET https://markdownregistry.com/api/v1/blob/911936caa39233d39a6a8ebd8cbd4d4bb6d7358580ace895743b74c81e3f3ea5

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from affaan-m/ecc

Every file in affaan-m/ecc

Other files named database-migrations

Browse by kind, by grade A, or by owner.