wp-playground
作成者 WordPresswp-playgroundスキルを使うと、プラグインやテーマのテスト、バージョン切り替え、ブループリント、スナップショット、分離されたデバッグのために、使い捨てで再現性の高いWordPress Playground環境を作成できます。`@wp-playground/cli` を使ったブラウザまたはCLIのワークフローに対応しており、バックエンド開発、QA、制御された不具合再現に特に役立ちます。
このスキルは84/100で、汎用的なプロンプトではなくWordPress Playgroundに特化したワークフローを求めるディレクトリ利用者にとって、有力な掲載候補です。リポジトリには、スキルを正しく起動し、適切なコマンドを選び、どの場面に向くかを判断するのに十分な操作情報があります。特に、使い捨てのテストサイト、ブループリント、スナップショット、デバッグの用途で有効です。実験的な要素に伴う注意点は残るものの、導入判断を支える材料は十分です。
- トリガーのしやすさが高いです。frontmatterの説明で、WordPress Playground、CLI、ブループリント、スナップショット、Xdebugに関する主要ワークフロー、必要な入力、互換性が明示されています。
- 運用面の分かりやすさも良好です。SKILL.mdと関連資料に、server、run-blueprint、build-snapshot、mounts、WP/PHPバージョンの選択、デバッグ向けの具体的なコマンドがあります。
- エージェントにとって使いやすい構成です。使い捨てテスト、再現可能なセットアップ、分離されたデバッグのための繰り返し可能なワークフローが整理されており、試行錯誤を減らせます。
- 名称やPlaygroundの対象範囲が実験的であるため、本番環境や幅広いWordPress管理ではなく、一時的なテスト用途に最適です。
- SKILL.mdにインストールコマンドがなく、scripts/resourcesもないため、自動セットアップではなくドキュメント内のCLI案内を頼る形になります。
wp-playground skill の概要
wp-playground は、完全なローカル WordPress スタックの代わりに、使い捨てで再現性のある環境が必要なときに WordPress Playground のインスタンスをセットアップし、操作するための skill です。wp-playground skill は、プラグインやテーマの開発者、QA テスター、そして問題の再現、バージョン検証、ブラウザ内または @wp-playground/cli 経由で実行できるセットアップ共有を行いたいバックエンド開発者に特に向いています。
最も重要なのは、この skill が解決する仕事です。つまり、正しいコードをマウントし、適切な WP/PHP バージョンを選び、デバッグや成果物化に必要な制御を確保したうえで、WordPress サイトを素早く立ち上げることです。これは汎用的な「WordPress のプロンプトを書いてくれる skill」ではなく、制御されたセットアップ、blueprint、snapshot、分離されたテストのための実用的な wp-playground guide です。
使い捨ての WP ワークフローに最適なケース
wp-playground は、次のような場合に使います。
- プラグインやテーマの変更を検証するために一時的な WordPress サイトを立ち上げたい
- 特定の WordPress バージョンや PHP バージョンでテストしたい
- 共有用の blueprint を実行したり snapshot を生成したりしたい
- 本番環境やローカルのデータベースに影響を与えず、挙動を切り分けてデバッグしたい
何が違うのか
最大の差別化ポイントは、CLI ベースのワークフロー、blueprint 対応、そして予測しやすい一時的なランタイムです。wp-playground は、見た目の洗練よりも再現性を重視する場面で強みがあります。また、環境が SQLite ベースかつ WebAssembly ベースであることも重要で、従来のサーバー型 WordPress インストールとは性能面も制約も変わります。
先に知っておくべき重要な制約
これは、使い捨て環境の範囲内で作業できる場合にだけ適した選択肢です。本番データ、長期的に保持するローカル状態、あるいは従来の MySQL ベース WordPress スタックが必要なワークフローには向きません。最もよい結果を得るには、これをメインの開発環境の代替ではなく、制御されたテストベッドとして扱ってください。
wp-playground skill の使い方
インストールしてソースファイルを開く
まずはディレクトリ用ツールに標準的な wp-playground install の流れで進め、そのうえで作業を依頼する前に skill のソースファイルを読みます。この repo の重要ファイルは SKILL.md、references/blueprints.md、references/cli-commands.md、references/debugging.md です。これらのファイルを見ると、skill がどんな入力を想定しているか、どの CLI フラグが重要かが分かります。
ざっくりした目的を使えるプロンプトに変える
弱いプロンプトの例: 「私のプラグイン用に WordPress Playground をセットアップして」
より強いプロンプトの例: 「wp-playground を使って packages/my-plugin のプラグイン用に使い捨てのローカルインスタンスを作成し、プロジェクトを自動マウントして、WP 6.9 と PHP 8.3 でテストし、正確な CLI コマンドと必要な mount または blueprint の調整を示してください。」
wp-playground usage では、次の情報を入れてください。
- プロジェクトのパス
server、run-blueprint、build-snapshotのどれを使いたいか- WordPress と PHP のバージョン
- コードを auto-mount するかどうか
- Xdebug や blueprint ファイルが必要かどうか
先に適切なワークフローを選ぶ
インタラクティブに確認しながらライブテストしたいなら server --auto-mount を使います。起動して終了するスクリプト化されたセットアップが必要なら run-blueprint を使います。あとで渡したり再実行したりできる再利用可能な成果物がほしいなら build-snapshot を使います。バックエンドのデバッグが目的なら、単に起動コマンドを求めるのではなく、具体的に何が失敗しているかを伝え、Xdebug 前提の手順を依頼してください。
repo はこの順番で読む
よい wp-playground guide は、まず SKILL.md を読み、次にコマンドの形を確認するために references/cli-commands.md を参照し、セットアップ自動化が必要なら references/blueprints.md を読み、ブレークポイント、mount、起動停止のハングが絡むなら最後に references/debugging.md を確認する流れです。この順番なら推測が減り、--mount-before-install や --blueprint-may-read-adjacent-files のようなフラグを見落としにくくなります。
wp-playground skill FAQ
wp-playground はフロントエンドのデモ専用ですか？
いいえ。wp-playground skill は、分離された WordPress の挙動、再現可能なバージョン、デバッグセッションが必要なときに、プラグイン、テーマ、バックエンド開発で特に役立ちます。見た目のデモよりも、制御された実行に重点があります。
先に完全なローカル WordPress 環境を用意する必要はありますか？
通常はありません。wp-playground install の目的は、従来型のスタックをプロビジョニングせずに、すばやく使える環境を用意することにあります。すでにローカルスタックがあっても、きれいな比較対象が必要なときや、特定の WP/PHP の組み合わせを試したいときには wp-playground が有用です。
どんなときに使わないべきですか？
本番データ、永続的なコンテンツ作業、MySQL 固有の挙動に依存するワークフローには使わないでください。プラグインが外部サービス、ファイルシステムの永続性、長時間動作する状態に依存しているなら、それらの依存関係を blueprint で明示的にモデル化できない限り、wp-playground は適切な第一選択ではないかもしれません。
初心者にも向いていますか？
はい。タスクがシンプルで、CLI の例にきちんと従うなら使いやすいです。主な失敗要因は入力の曖昧さです。プロジェクトパス、対象バージョン、blueprint が必要かどうかを指定しないと、結果の使い勝手は下がります。初心者は、一度に 1 つの明確なワークフローだけを依頼するのが最もよい結果につながります。
wp-playground skill をより良く使うために
正確なセットアップ変数を最初に渡す
品質を大きく上げるには、プロジェクトのルート、希望する WP/PHP バージョン、コードを auto-mount するか明示的に mount するかを指定することが重要です。たとえば、「wp-playground を使って plugins/contact-form を WP 6.9 と PHP 8.3 で --auto-mount 付きでテストして」は、「うまく動かして」のような指示よりずっと良い結果になります。
目的だけでなく、失敗のしかたも伝える
デバッグなら、何が壊れているかを具体的に伝えてください。たとえば、インストールに失敗する、プラグインの hook が発火しない、REST レスポンスが不正、PHP 8.3 でしか出ないバージョン依存の regression がある、などです。そうすると skill は server、run-blueprint、build-snapshot のどれを選ぶべきか判断しやすくなり、wp-playground for Backend Development のワークフローも実用性が上がります。
mount と blueprint のミスに注意する
よくある問題は、相対 mount パス、install 前に存在していないといけないファイル、そしてローカルの隣接ファイルを参照する必要がある blueprint です。最初の実行で失敗したら、絶対パスを追加する、--mount-before-install が必要か確認する、blueprint がローカル資産を読むかどうかを明示する、といった形でプロンプトを改善してください。デバッグでは、Xdebug の設定詳細と期待する IDE 側のマッピングも依頼するとよいです。
1 回に 1 つの変数だけ変えて試す
最初の出力が惜しいけれど完全ではないなら、変えるのは 1 つだけにします。WP バージョン、PHP バージョン、mount モード、blueprint のソースのどれか 1 つだけです。そうすると、問題が環境選択にあるのか、コマンドフラグにあるのか、それともセットアップ手順そのものにあるのかを切り分けやすくなります。