wp-migration-upgrade-review

WordPress の移行とアップグレードのレビュー用スキル

概要

WordPress のプラグインとテーマのアップグレード処理を体系的にレビューします。基本原則： アップグレードは、繰り返し実行でき、バージョンを考慮し、段階的に進行し、実際の本番データに対して安全である必要があります。レビューでは、スキーマの変更、オプションの移行、バージョンフラグ、有効化時のアップグレード、バックグラウンドでのバックフィル、冪等性、ロールバックのリスク、下位互換性を確認します。

使用するタイミング

次の場合に使用します：

• スキーマまたはオプションの移行をレビューする場合
• dbDelta() の使用状況を監査する場合
• バージョン管理されたアップグレード処理を確認する場合
• バックグラウンドでのバックフィルや一度限りの修復ジョブをレビューする場合
• 既存のインストール環境に影響するリスクの高いリリースを準備する場合

次の場合は使用しないでください：

• 移行ロジックを伴わない、パフォーマンスのみのレビュー
• アップグレードの観点を伴わない、一般的なプラグインアーキテクチャのレビュー
• 製品アップグレードとは無関係な、一度限りのコンテンツインポート

コードレビューワークフロー

1. 移行対象を特定する

   • 有効化フックの設定
   • バージョン比較によるアップグレード処理
   • バックグラウンドでのバックフィル
   • 手動修復ツール

2. まず安全性を確認する

   • バージョンガードがある
   • 処理が冪等である
   • 破壊的な操作が明示され、正当化されている
   • 大量のデータ処理がチャンクに分割されている

3. スキーマとデータフローをレビューする

   • dbDelta() と生 SQL の使い分け
   • オプションの名前変更／コピー／削除の順序
   • バックフィルの永続性と進捗の追跡
   • アップグレード完了フラグ

4. 重大度を適用する

   • CRITICAL： バージョンガードがない、チェックを伴わない破壊的な書き込み、ページ読み込み時に実行される時間のかかるアップグレード
   • WARNING： バッチ処理がない、ロールバックの検討がない、部分的な状態が追跡されない
   • INFO： 移行レジストリやログをより明確にできる可能性がある

ファイルタイプ別の確認事項

バージョン管理されたアップグレード処理

• CRITICAL：バージョン比較なしで、すべてのリクエスト時にアップグレードロジックが実行される
• WARNING：複数の移行ステップがあるが、順序付けられたアップグレードマップがない
• INFO：移行レジストリを一元化できる可能性がある

スキーマの変更

• CRITICAL：既存のインストール環境への配慮なしに、生の CREATE TABLE または ALTER TABLE を実行する
• WARNING：テーブルのバージョン追跡なしで dbDelta() を使用している
• INFO：スキーマ移行とデータ移行のフェーズを分けられる可能性がある

データのバックフィル

• CRITICAL：通常のページ読み込み時に全テーブルのバックフィルを行う
• WARNING：バッチ処理または進捗オプションがない
• WARNING：再試行または再開可能な設計がない
• INFO：Action Scheduler または WP-CLI のサポートを利用できる可能性がある

すばやく検出するための検索パターン（MIG-21）

以下の rg コマンドを使用して、移行をすばやくスキャンします。

CRITICAL パターン

# Version comparisons and upgrade flags
rg -n "version_compare|get_option\s*\(.*version|update_option\s*\(.*version" . -g '*.php'

# Schema changes
rg -n "dbDelta|CREATE TABLE|ALTER TABLE|DROP TABLE" . -g '*.php'

# Activation and upgrade hooks
rg -n "register_activation_hook|upgrader_process_complete|admin_init|init" . -g '*.php'

WARNING パターン

# Batch candidates and large loops
rg -n "foreach|while" . -g '*.php'

# Background processing and schedulers
rg -n "wp_schedule_event|as_schedule_single_action|WP_CLI" . -g '*.php'

# Delete or rename operations
rg -n "delete_option|rename|migrate|backfill" . -g '*.php'

INFO パターン

# Upgrade classes or managers
rg -n "Migration|Upgrade|Installer|Schema" . -g '*.php'

参考ファイル

• references/versioned-upgrades.md - バージョンフラグ、順序付けられた移行、冪等なアップグレード処理
• references/schema-and-backfill-guide.md - dbDelta()、テーブルの変更、バックフィル、バッチ処理、リリースの安全性

出力形式（MIG-23）

各指摘には、重大度、ファイル参照、移行リスク、安全な修正方法を含めてください。本番環境でのタイムアウト、部分的なデータ状態、または取り消せないデータ損失のリスクがある場合は、明記してください。