菜单
任意の ORM/データベーススタックに適用可能な安全なデータベーススキーママイグレーションパターン。以下の場合に使用: - データベーススキーマの変更（カラム・テーブルの追加/削除） - 安全なマイグレーションの実行 - データベースのバージョニングとロールバックの管理 - マイグレーションリスクの評価や安全なデプロイの計画 - スキーマドリフトやマイグレーションの競合への対処 Trigger phrases: database migration, schema change, add column, migration rollback, schema drift
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
設定ファイルとソースコードからプロジェクトの技術スタックを自動検出。 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
ルール遵守と創造的な問題解決のバランスを取るためのフレームワーク。 Anthropic のエージェント設計に関する研究に基づく。 使用場面: - 複数の有効なアプローチがある複雑な判断に直面した場合 - 状況に対して指示が過度に規範的に感じられる場合 - ガイドラインを特定のコンテキストに適応させる必要がある場合 - 精度要件と革新的なソリューションのバランスを取る場合 Trigger phrases: think creatively, use judgment, adapt approach, better solution, flexibility
曖昧なリクエストを明確にするための構造化された要件インタビューフレームワーク。使用場面: - ユーザー要件が不明確または不完全な場合 - 新機能を開始し要件を収集する必要がある場合 - ユーザーのニーズ、制約、優先順位を理解する必要がある場合 - ビジネスリクエストを技術仕様に変換する場合 - ユーザーが詳細なしに「～したい」「～を追加して」と言う場合 Trigger phrases: gather requirements, clarify request, what do you need, interview user, requirements gathering, unclear request
すべてのユーザー向けコンテンツに日本語出力を強制する。 使用場面: - エージェント出力を日本語にする必要がある場合 - レスポンス全体の言語の一貫性を検証する場合 - 仕様書やドキュメントを日本語で生成する場合 Trigger phrases: Japanese, 日本語, language mode, output language
| 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"
本番環境にマイグレーションをデプロイする前:
データベースがマイグレーションと異なる場合:
複数のマイグレーションが競合する場合:
マイグレーションが途中で失敗した場合:
データの安全性に不可欠。違反はデータ損失を引き起こす可能性。
安全な操作に重要。適切な理由がある場合はオーバーライド可。
堅牢なマイグレーション実践のための推奨事項。