公開前の検査

MCP Abilities – Check Runner:検査が終わっても、合格とは限りません

エラーがゼロでも、検査は不合格になることがあります。Check Runner は AI アシスタントを WordPress 公式の Plugin Check に接続し、警告も不合格の理由として扱います。公開前に何を直すべきか、結果をもとに判断できます。

プラグイン公開前の検査を表すイラスト

警告が一つでもあれば合格しません

公開候補のプラグインに、エラーはなく、警告が二つあるとします。検査自体は完了していますが、Check Runner は不合格と判定します。エラー数と警告数の両方がゼロである必要があります。

公式の実行機構が提供するすべての検査を、実験的な検査も含めて実行します。検査項目やカテゴリを絞る指定は無視されます。利用できる検査は、インストールされている Plugin Check のバージョンによって決まります。

Plugin Check が情報を提供する場合、各指摘にはファイル、行、列、メッセージ、診断コードが含まれます。これらを手がかりに問題を特定してコードを修正し、変更後のプラグインを再検査します。

黄色い警告によって検査用の遮断機が閉じたままになり、ソフトウェアの箱が止められている

黄色い警告も停止の理由になります。エラーも警告もゼロの場合にだけ合格します。

ジョブ参照は受付票であり、合格証ではありません

バックグラウンドで実行するには async: true を指定します。WordPress が検査を予約する際に、Check Runner はジョブ参照を返します。既定の呼び出しは同期実行です。

同じジョブを plugin-check/job-status で確認します。Pending は未開始、running は実行中です。Complete のジョブには、合格した結果、不合格となる指摘、または実行エラーが含まれる可能性があります。

バックグラウンド実行には WordPress cron と、サーバーが PHP に認める実行リソースが必要です。ジョブ参照が返っても、開始や完了は保証されません。停止したままのジョブや中断されたジョブは、新たに依頼する前に原因を調べてください。

ジョブの受付票がバックグラウンド検査を通り、別の最終結果につながる様子

受付票は一つのジョブを追跡します。保存された最終結果を読んでから、プラグインを評価します。

インストール済み候補から、判断に使える結果へ

1. 対象のプラグインを指定する

適切な WordPress テストサイトに候補をインストールし、公式 Plugin Check を有効にします。プラグインのスラッグまたはベース名をアシスタントに伝え、確認の目的に応じて新規プラグイン用か更新用のモードを選びます。

2. 全項目を検査する

全項目の検査を依頼し、必要に応じてバックグラウンド実行を選びます。ジョブ参照を保存して状態を確認してください。予約に成功したことと、検査に合格したことは別です。

3. 件数と指摘内容を一緒に読む

まず実行が完了したかを確認し、次に合否、エラー数、警告数を読みます。指摘一覧が省略されている場合、件数は検査結果全体を反映していても、画面上の一覧にはすべての指摘が含まれていません。

4. 修正し、再検査と動作テストを行う

指摘を修正した後、変更済みプラグインを改めて全項目検査します。実際の機能や連携もテストしてください。Plugin Check に合格しても、正常動作の証明や WordPress.org での承認保証にはなりません。

応答には件数の上限があります

既定の応答に含まれる指摘は最大 100 件です。max_results で最大 500 件まで増やせます。エラーが警告より先に並ぶため、エラーが多いと警告の詳細が応答に表示されないことがあります。

残りを取得するページ送り機能はありません。truncated が true の場合は、公式 Plugin Check の画面でさらに詳細を確認してください。この応答を「すべての指摘」として扱わないでください。

二つの操作で必要な権限が異なります

plugin-check/run は検査を開始し、WordPress のプラグイン有効化権限を必要とします。plugin-check/job-status は保存済みジョブを読み取り、サイト設定を管理する権限を必要とします。

バックグラウンドジョブには、両方の権限を持つアカウントを使用します。Check Runner はソースファイルの修正、候補のインストール、リリースの公開を行いません。このバージョンには、ジョブの取り消しや削除の操作もありません。

WordPress との接続を準備する

Check Runner が示す最小要件は WordPress 6.9 以降と PHP 8.0 以降です。WordPress 6.9 には Abilities API が含まれます。サイトで利用でき、保守が継続されている PHP バージョンを使用してください。

公式の Plugin Check プラグイン をインストールし、有効にする必要があります。WordPress MCP Adapter を通じて認証済み MCP クライアントを接続し、必要な操作が検出されることを確認します。

MCP の構成によっては、検査の実行操作を検出できるようにするため、MCP Expose Abilities などの公開用レイヤーが必要です。検査を始める前に接続を確認してください。

プラグイン公開前の検査を表すイラスト

次の検査で何が分かるかを把握する

Check Runner をインストールし、二つの操作が利用できることを確認して、インストール済み候補の全項目検査を依頼します。最終結果とその限界を読んだうえで、公開するかを判断してください。