菜单
任意の ORM/データベーススタックに適用可能な安全なデータベーススキーママイグレーションパターン。以下の場合に使用: - データベーススキーマの変更（カラム・テーブルの追加/削除） - 安全なマイグレーションの実行 - データベースのバージョニングとロールバックの管理 - マイグレーションリスクの評価や安全なデプロイの計画 - スキーマドリフトやマイグレーションの競合への対処 Trigger phrases: database migration, schema change, add column, migration rollback, schema drift
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/MysMon/Spec-Workflow-Toolkit --skill migration命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
設定ファイルとソースコードからプロジェクトの技術スタックを自動検出。 Use when: 新規コードベースでの作業開始、言語/フレームワーク/ツールの特定。 Trigger phrases: detect stack, what framework, identify technology, project setup
REST、GraphQL、gRPC の API 設計パターン。 Use when: API の新規設計、OpenAPI 仕様作成、バージョニング/ページネーション設計。 Trigger phrases: API design, REST endpoint, GraphQL schema, OpenAPI, gRPC, pagination
エバリュエーター・オプティマイザーのフィードバックループによる反復改善。 Use when: 出力品質の反復改善、明確な評価基準がある複雑な出力の最適化。 Trigger phrases: iterate, refine, improve quality, feedback loop, evaluate and optimize
基于 SOC 职业分类
| name | migration |
| description | 任意の ORM/データベーススタックに適用可能な安全なデータベーススキーママイグレーションパターン。以下の場合に使用: - データベーススキーマの変更（カラム・テーブルの追加/削除） - 安全なマイグレーションの実行 - データベースのバージョニングとロールバックの管理 - マイグレーションリスクの評価や安全なデプロイの計画 - スキーマドリフトやマイグレーションの競合への対処 Trigger phrases: database migration, schema change, add column, migration rollback, schema drift |
| allowed-tools | Bash, Read, AskUserQuestion, Write, Glob, Grep, WebSearch, WebFetch |
| model | sonnet |
| user-invocable | true |
任意の ORM とデータベースに適用可能な安全なスキーママイグレーションパターン。このスキルはマイグレーションの原則と安全パターンを定義するものであり、特定の ORM コマンドを定義するものではない。
マイグレーション実行前:
特定のツールを前提とせずにマイグレーション関連の設定を探す:
# マイグレーションディレクトリと設定を確認
ls -la migrations/ db/migrate/ alembic/ prisma/ drizzle/ 2>/dev/null
ls -la *migrate* *migration* *.prisma diesel.toml 2>/dev/null
# 依存関係でマイグレーションツールを確認
grep -E 'prisma|drizzle|alembic|django|sequelize|typeorm|knex|goose|diesel|flyway' \
package.json pyproject.toml requirements.txt go.mod Cargo.toml pom.xml 2>/dev/null
# マイグレーションスクリプトを確認
grep -E 'migrate|migration|db:' package.json 2>/dev/null
grep -E '^(migrate|db)' Makefile 2>/dev/null
ツールが検出されたがコマンドが不慣れな場合:
WebSearch: "[ORM/ツール名] migration commands [year]"
WebFetch: [公式ドキュメント] → "Extract migration CLI commands"
これらのパターンは任意のデータベースとマイグレーションツールに適用:
安全なアプローチ（NOT NULL の場合は 2 ステップ）:
ステップ 1: nullable としてカラムを追加
ステップ 2: 必要に応じてデータをバックフィル
ステップ 3: NOT NULL 制約を追加（必要な場合）
理由: NOT NULL カラムを直接追加すると既存の行で失敗する。
安全なアプローチ（3 ステップ）:
ステップ 1: アプリケーションコードでカラムの使用を停止
ステップ 2: アプリケーション変更をデプロイ
ステップ 3: マイグレーションでカラムを削除
理由: コードが使用中のカラムを削除するとエラーが発生する。
安全なアプローチ（4 ステップ）:
ステップ 1: 新しいカラムを追加（旧のコピー）
ステップ 2: 旧から新にデータをコピー
ステップ 3: 新しいカラムを使用するようにコードを更新
ステップ 4: 旧カラムを削除
理由: 直接リネームするとデプロイ中に実行中のコードが壊れる。
安全なアプローチ:
- 小さなテーブル: 直接インデックス作成
- 大きなテーブル: コンカレント/オンラインインデックス作成を使用
理由: インデックス作成はテーブルをロックする。コンカレント作成はダウンタイムを回避。
注: コンカレントインデックスの構文はデータベースによって異なる - 特定のデータベースについてリサーチすること。
| 変更タイプ | リスクレベル | 軽減策 |
|---|---|---|
| nullable カラム追加 | 低 | 不要 |
| デフォルト値付きカラム追加 | 低 | デフォルト値を確認 |
| NOT NULL カラム追加 | 中 | まず nullable で追加、バックフィル、制約追加 |
| カラム削除 | 高 | コードが使用していないことを確認 |
| カラムリネーム | 高 | 追加/コピー/削除パターンを使用 |
| カラム型変更 | 高 | データ互換性をテスト |
| インデックス追加（小テーブル） | 低 | 不要 |
| インデックス追加（大テーブル） | 中 | コンカレント作成を使用 |
| インデックス削除 | 低 | クエリに不要であることを確認 |
常にロールバックを計画する:
マイグレーションツールのロールバックコマンドを発見する:
WebSearch: "[マイグレーションツール] rollback command"
本番環境にマイグレーションをデプロイする前:
データベースがマイグレーションと異なる場合:
複数のマイグレーションが競合する場合:
マイグレーションが途中で失敗した場合:
データの安全性に不可欠。違反はデータ損失を引き起こす可能性。
安全な操作に重要。適切な理由がある場合はオーバーライド可。
堅牢なマイグレーション実践のための推奨事項。