WordPress WP-CLI and Ops スキル

概要

WP-CLIを中心としたWordPressの運用ワークフローに対する体系的なレビューガイダンスです。基本原則： 運用コマンドは、データに触れたり本番環境での作業を実行したりする前に、スコープ、環境、副作用を明示的に示す必要があります。カスタムCLIコマンド、search-replaceプラン、マルチサイトのターゲッティング、cronおよびキャッシュ運用、メンテナンススクリプト、デプロイ時の自動化をカバーしています。

使用場面

使用する場合:

• カスタムWP-CLIコマンドまたはコマンドクラスをレビューする
• wpコマンドを実行するシェルスクリプトまたはドキュメントを監査する
• 安全なsearch-replaceまたはマイグレーション操作を計画する
• マルチサイトまたはネットワーク全体の運用ステップをチェックする
• cron、キャッシュ、エクスポート、インポート、またはメンテナンスワークフローをレビューする

使用しない場合:

• 運用サーフェスを持たない一般的なプラグインアーキテクチャ
• 運用ワークフローのないパフォーマンス調整
• Playgroundのみのセットアップフロー(wp-playground-developmentを使用)
• 静的解析設定(wp-phpstan-reviewを使用)

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

1. 運用サーフェスを特定する

   • カスタムWP_CLI::add_command()登録
   • wpコマンド例を含むプロジェクトドキュメント
   • デプロイスクリプト、CIジョブ、またはメンテナンススクリプト
   • マルチサイトのランブック、またはマイグレーション計画

2. スコープとターゲッティングを最初にチェックする

   • コマンドはサイト固有、ネットワーク全体、または環境依存か?
   • --url、--path、または明示的なテーブルターゲットが必要か?
   • ワークフローは現在のインストール環境の前提に依存しているか?

3. 安全性と可逆性をレビューする

   • ドライラン対応(可能な場合)
   • 破壊的なステップの確認またはログ記録
   • 高リスク変更前のバックアップ/エクスポートステップ
   • 読み取り専用コマンドと変更コマンドの明確な区別

4. コマンド実装をレビューする

   • 入力検証と引数処理
   • 妥当なデフォルト値
   • 有用な成功/エラー出力
   • 読み取り専用コマンド中の隠れた書き込みがないこと

5. 検出結果を分類する

   • CRITICAL: セーフガード無しの破壊的操作、誤ったマルチサイトスコープ、本番環境に悪影響のあるsearch-replace、検証されていないCLI入力によるデータ損失
   • WARNING: 曖昧な環境ターゲッティング、脆弱なシェル例、ドライランがない、弱いログ、チャンキング無しの長時間実行タスク
   • INFO: エイリアスをドキュメント化、コマンドUXを改善、読み取りと書き込みコマンドを分離できる

ファイルタイプ別チェック

カスタムWP-CLIコマンド

• CRITICAL: 引数検証または機能/コンテキストチェックなしの書き込みコマンド
• WARNING: コマンド名またはシノプシスが副作用を示していない
• WARNING: 読み取り専用検査と変更を混在させるコマンド
• INFO: 構造化出力またはより明確なステータスメッセージを返すことができる

Search-ReplaceおよびDB操作

• CRITICAL: --dry-runまたはスコープ制限なしのwp search-replace例
• CRITICAL: --network明示的レビューまたはテーブルターゲッティングなしのネットワーク全体置換
• WARNING: URLを置換する際に--skip-columns=guidがない
• WARNING: パフォーマンス警告なしで正規表現search-replaceが気軽に使用されている

マルチサイト運用

• CRITICAL: ネットワーク全体の状態に触れている間に現在のサイトを前提とするコマンド
• WARNING: マルチサイト内のサイト固有タスクの--urlがない
• WARNING: ロールバック注記なしのサイト作成/削除ワークフロー
• INFO: wp site / wp super-adminの含意についてさらにドキュメント化できる

自動化とメンテナンススクリプト

• WARNING: wp eval/wp eval-fileを使用している(カスタムコマンドがより安全)
• WARNING: チャンキングまたは進捗出力なしの長いメンテナンスジョブ
• INFO: 検査、エクスポート、変更を別々のステップに分割できる

高速検出用検索パターン (OPS-21)

これらのrgコマンドを使用してWP-CLIおよび運用ワークフローを素早く特定します。

コマンド検出

rg -n "WP_CLI::add_command|class .* extends WP_CLI_Command" . -g '*.php'
rg -n "\bwp [a-z0-9:-]+" . -g '*.{md,sh,yml,yaml,json}'

高リスク変更

rg -n "wp search-replace|wp db reset|wp db drop|wp site delete|wp plugin deactivate" . -g '*.{md,sh,yml,yaml}'
rg -n "wp eval|wp eval-file" . -g '*.{md,sh,yml,yaml}'

マルチサイトおよびスケジューリング

rg -n "wp site|wp super-admin|--network|--url=" . -g '*.{md,sh,php,yml,yaml}'
rg -n "wp cron|wp cache|wp transient" . -g '*.{md,sh,php,yml,yaml}'

参照ファイル

• references/command-patterns.md - カスタムコマンド設計、引数処理、運用UX
• references/multisite-and-search-replace.md - マルチサイトスコープ、wp site、安全なwp search-replace使用法
• references/automation-and-safety.md - デプロイスクリプト、メンテナンスジョブ、チャンキング、ロールバック思考
• references/sample-wp-cli-command.php - 検証、ドライラン、チャンキング付きのサンプルカスタムコマンド
• references/sample-maintenance-runbook.md - 検査、ドライラン、実行、検証段階を含むサンプルランブック

出力形式 (OPS-23)

検出結果ごとに以下を含めてください:

1. 重大度: CRITICAL、WARNING、またはINFO
2. ファイルと行番号
3. 運用リスクの概要
4. WP-CLIまたはランタイム運用にとって重要な理由
5. 推奨される安全なパターン

問題が見つからない場合は、その旨を明確に述べ、ドライランの欠落、弱いログ、限定的なロールバックドキュメントなど、残存する運用上のギャップについて言及してください。