WordPress Playground 開発スキル

概要

WordPress Playground ベースのデモと再現可能な環境に対する体系的なレビューガイダンス。**基本原則:**Playground セットアップは決定的で、ポータブルで、Blueprint または CLI エントリーポイントだけから簡単に理解できるべきものです。レビューは Blueprint 構造、ローカル CLI 使用法、埋め込みデモ、再現環境、およびデモ固有の WordPress 設定をカバーします。

使用するタイミング

使用する場合:

• Blueprint JSON ファイルをレビューする場合
• Playground を埋め込む、またはリンクするドキュメントを監査する場合
• ゼロセットアップのバグ再現またはデモを構築する場合
• ローカルワークフローやテストで Playground CLI 使用法をレビューする場合
• ブロック、プラグイン、またはテーマの反復可能な環境を設計する場合

使用しない場合:

• Playground のない一般的なブロックまたはプラグインレビュー
• Playground コンテキスト外の WP-CLI 操作
• スタティック分析または CI セットアップのみ

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

1. Playground エントリーポイントを特定する

   • Blueprint JSON
   • Playground CLI コマンド
   • 埋め込み iframe または blueprint URL
   • 問題を再現するために使用されるローカルドキュメントまたはスクリプト

2. 最初に再現性を確認する

   • 必要に応じて明示的な WordPress および PHP バージョン
   • ステップは順序付けされており自己完結している
   • Blueprint/ドキュメント外の隠れた手動ステップはない

3. セットアップステップをレビューする

   • テーマ/プラグインのインストールと有効化
   • ログイン、サイトオプション、コンテンツシーディング
   • ファイル書き込み、コピー、またはマウント
   • Blueprint 内で使用される wp-cli ステップ

4. 開発者エルゴノミクスをレビューする

   • 誰かが推測なしに再度実行できるか?
   • ランディングページは意味のあるものか?
   • ローカルフローとブラウザベースのフローは明確に分離されているか?

5. 結果を分類する

   • **CRITICAL:**非再現可能なセットアップ、隠れた依存関係、破損したステップ順序、ドキュメント化されていない外部の前提条件
   • **WARNING:**バージョンが暗黙的、過度にもろいマウント、紛らわしいランディングページ、小さな問題に対する重い再現
   • **INFO:**ステップを簡潔にする、デモとテストデータを分割する、またはより明確な Blueprint パターンを使用できる

ファイルタイプ固有のチェック

Blueprint ファイル

• CRITICAL:Blueprint を機能しなくする必須セットアップステップの欠落
• WARNING:バージョン互換性が重要な場合に明示的な preferredVersions がない
• WARNING:再現が Blueprint に隣接するファイルに依存しており、ドキュメント化されていない
• INFO:より明確な landingPage を設定できる

Playground CLI ワークフロー

• WARNING:ローカルワークフローが server または start を使用し、マウント が ドキュメント化されていない
• WARNING:Blueprint パスまたは自動マウント の前提条件が暗黙的である
• INFO:run-blueprint または build-snapshot を使用して、より決定的なフローを実現できる

埋め込みデモと再現

• CRITICAL:デモが Blueprint でキャプチャされていない手動管理者セットアップに依存している
• WARNING:埋め込み例が、実証されている問題に対して大きすぎるか一般的すぎる
• INFO:教育/デモコンテンツをバグ再現コンテンツから分割できる

クイック検出用の検索パターン (PG-21)

以下の rg コマンドを使用して Playground 関連のファイルとセットアップロジックを見つけます。

Playground 発見

rg -n "playground|blueprint|@wp-playground" . -g '*.{md,json,js,ts,tsx,yml,yaml}'
rg -n "\"steps\"|\"landingPage\"|\"preferredVersions\"" . -g '*.json'

CLI および埋め込みフロー

rg -n "run-blueprint|build-snapshot|@wp-playground/cli|npx @wp-playground/cli" . -g '*.{md,js,ts,sh,yml,yaml}'
rg -n "blueprint-url|playground.wordpress.net|wordpress.org/playground" . -g '*.{md,html,js,ts}'

再現ステップ

rg -n "\"step\": \"(login|wp-cli|installPlugin|installTheme|writeFile|mkdir|cp|mv|enableMultisite)\"" . -g '*.json'

リファレンスファイル

• references/blueprint-patterns.md - Blueprint 構造、ステップ選択、決定的なセットアップ
• references/cli-and-local-workflows.md - @wp-playground/cli、マウント、ローカルワークフロー、およびスナップショット使用法
• references/embedding-and-repros.md - 埋め込みデモ、blueprint URL、および問題再現パターン
• references/sample-playground-blueprint.json - ローカルテストまたは適応用の最小限の再現可能な Blueprint フィクスチャ

出力形式 (PG-23)

各検出結果には以下を含めます:

1. 重要度:CRITICAL、WARNING、または INFO
2. ファイルと行番号
3. 再現またはデモの問題のサマリー
4. Playground の信頼性または明確性にとって重要な理由
5. 推奨される修正

問題が見つからない場合は、明確にそう述べて、バージョンドリフト、再現ノートの欠落、または脆いローカルマウントなど、残存する曖昧性に言及してください。