affaan-m/ECC/docs/ja-JP/skills/database-migrations/SKILL.md
database-migrations
Review database-migrations's use cases, installation, workflow, and original source instructions.
- Source repository stars
- 234,327
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-07-27
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
本番環境システム用の安全で可逆的なデータベーススキーマ変更。
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/affaan-m/ECC --skill "docs/ja-JP/skills/database-migrations"Inspect the Agent Skill "database-migrations" from https://github.com/affaan-m/ECC/blob/4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38/docs/ja-JP/skills/database-migrations/SKILL.md at commit 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
アクティベーション時期
データベーステーブルの作成または変更
データベーステーブルの作成または変更列またはインデックスの追加/削除データマイグレーション(バックフィル、変換)の実行 - 02
コア原則
1. すべての変更はマイグレーション — 本番環境データベースを手動で変更しない 2. マイグレーションは本番環境で前方のみ — ロールバックは新しい前向きマイグレーション使用 3. スキーマとデータマイグレーションは分離 — 1つのマイグレーションでDDLとDMLを混ぜない 4. 本番環境サイズのデータに対してマイグレーションをテスト — 100行で機能するマイグレーション10M上でロックされる場合がある 5. マイグレーションは展開後は不変 — 本番環境で実行されたマイグレーションを編集しない
すべての変更はマイグレーション — 本番環境データベースを手動で変更しないマイグレーションは本番環境で前方のみ — ロールバックは新しい前向きマイグレーション使用スキーマとデータマイグレーションは分離 — 1つのマイグレーションでDDLとDMLを混ぜない - 03
マイグレーション安全チェックリスト
[ ] マイグレーションはUPとDOWNの両方を持つ(または明示的に不可逆としてマーク)
[ ] マイグレーションはUPとDOWNの両方を持つ(または明示的に不可逆としてマーク)[ ] 大型テーブルの完全テーブルロックなし(並行操作使用)[ ] 新しい列はデフォルトまたはnullable(デフォルトなしでNOT NULLを追加しない)
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 59/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 234,327 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | catalog record | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- affaan-m/ECC
- Skill path
- docs/ja-JP/skills/database-migrations/SKILL.md
- Commit
- 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38
- License
- MIT
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
データベースマイグレーションパターン
本番環境システム用の安全で可逆的なデータベーススキーマ変更。
アクティベーション時期
- データベーステーブルの作成または変更
- 列またはインデックスの追加/削除
- データマイグレーション(バックフィル、変換)の実行
- ゼロダウンタイムスキーマ変更を計画
- 新しいプロジェクト用のマイグレーションツール設定
コア原則
- すべての変更はマイグレーション — 本番環境データベースを手動で変更しない
- マイグレーションは本番環境で前方のみ — ロールバックは新しい前向きマイグレーション使用
- スキーマとデータマイグレーションは分離 — 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;
詳細についてはドキュメントを参照してください。
Alternatives
Compare before choosing
affaan-m/ECC
database-migrations
Database migration best practices for schema changes, data migrations, rollbacks, and zero-downtime deployments across PostgreSQL, MySQL, and common ORMs (Prisma, Drizzle, Django, TypeORM, golang-migrate). Use when planning or implementing database schema changes.
affaan-m/ECC
database-migrations
Database migration best practices for schema changes, data migrations, rollbacks, and zero-downtime deployments across PostgreSQL, MySQL, and common ORMs (Prisma, Drizzle, Kysely, Django, TypeORM, golang-migrate).
affaan-m/ECC
database-migrations
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).
affaan-m/ECC
database-migrations
Use it for data analysis tasks; the detail page covers purpose, installation, and practical steps.