wp-plugin-directory-guidelines について
WordPress.org プラグインディレクトリの要件に照らして、WordPress プラグインを審査するスキルです。ライセンス、命名、トライアルウェア、Plugin Check の結果を扱い、根拠の提示や判断が難しいポリシー上の問題のエスカレーションも案内します。
主な機能
- 01ディレクトリの18項目ガイドライン審査
- 02GPL ヘッダーと互換性の確認
- 03プラグイン名と slug の審査
- 04トライアルウェアとフリーミアムの評価
- 05Plugin Check の結果を文脈に沿って分析
- 06根拠に基づく報告のガイド
活用シーン
- 01WordPress.org への申請前のプラグイン審査
- 02同梱ライブラリの GPL 互換性確認
- 03有料版への誘導やトライアル UI の評価
- 04Plugin Check のエラーと警告の分析
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wordpress/ agent-skills --skill wp-plugin-directory-guidelinesインストール後、Claude Code で/wp-plugin-directory-guidelinesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/gpl-compliance.mdguideline-review-checklist.mdnaming-rules.mdplugin-check.md詳細
概要
WordPress.org プラグインディレクトリの18項目のガイドラインに関する正式なリファレンスです。GPL ライセンス、プラグインの命名規則と商標ルール、トライアルウェアの制限、その他すべての申請要件を網羅しています。
使用する場面
以下の場合にこのスキルを使用してください。
- WordPress プラグインが WordPress.org プラグインディレクトリのガイドラインに準拠しているか確認する
- プラグインまたは同梱ライブラリの GPL ライセンス互換性を確認する
- プラグインファイルのライセンスヘッダーを検証する
- 申請前に、よくあるガイドライン違反を特定する
- WordPress.org で許可されていること、許可されていないことについての質問に回答する
- プレミアム版への誘導やアップセルのフロー、ライセンス確認、フリーミアムの位置付けを評価する
- トライアルウェア違反にあたる「ティーザー」や「プレビュー」の UI を確認する
- Plugin Check でプラグインの変更を検証し、エラーや警告を文脈に沿って評価する
必要な入力
- プラグインのソースコード(または確認対象の特定ファイル)
- 任意:命名規則やライセンスを確認するためのプラグインの readme とプラグインヘッダーのメタデータ
- 自動検証の場合:対象プラグインのスラッグ/パス、ローカルの WordPress 環境とコマンド実行環境、利用可能なテスト、タスクで修正が許可されているか、確認のみか
手順
確認範囲は依頼内容に合わせてください。ライセンスや命名に関する概念的な質問には、WordPress のインストールや完全な監査は必要ありません。
- プラグインのライセンスヘッダーを、以下の有効なライセンスヘッダーのセクションと照合します。
- 18項目のガイドラインのチェックリストを確認し、特にガイドライン1、4、5、7、8、17に注意します。
- guideline-review-checklist.md(ガイドライン5のセクション)のチェックリストを使用して、トライアルウェア/フリーミアムへの準拠を確認します。
- サードパーティーのコードが同梱されている場合は、以下の**GPL 互換ライセンス(簡易版)**と照合してライセンスの互換性を確認します。
- 以下の**よくある GPL 違反(簡易版)**に該当するものがないか確認します。
- 判断が難しいケースについては、詳細なリファレンスと GNU GPL FAQ を参照します。
- ソースコードの確認や変更後の検証では、Plugin Check validation を読み込みます。テストとチェックを実施し、結果を評価し、許可された修正を適用して、再テストします。このリファレンスには、コマンド、レポート要件、トラブルシューティングが記載されています。
検証
- 以下のライセンス、命名規則、または Plugin Check のレポート作成ガイダンスに従い、各結論の根拠を報告します。手動確認、実行したチェック、今後の推奨手順を区別してください。
失敗時の対処/デバッグ
- 自動検証を利用できない場合も、手動確認を続行し、Plugin Check validation に記載されている前提条件と網羅性に関する代替手段を利用してください。実行していないチェックを合格と報告してはいけません。
エスカレーション
ツールの動作については Plugin Check の公式ドキュメントを、ポリシーについてはディレクトリのガイドラインを参照してください。解決していないポリシーの曖昧さ、判断に確信が持てない指摘、許可された範囲外の修正は、人間による確認が必要であることを明示してください。
18項目のガイドライン確認チェックリスト
guideline-review-checklist.md のガイドライン別の詳細なチェックリストを使用してください。このリファレンスファイルを読み込むのは、ガイドライン全体の監査を依頼された場合に限ります。
GPL への準拠(ガイドライン1の詳細)
ライセンス表の全項目、互換性に関する注意点、例については gpl-compliance.md を使用してください。このインラインのセクションは、簡易的な判断の手引きとして使用してください。
検証(ライセンス)
- ライセンスに関する問題を報告する際は、必ずガイドライン1を示し、ファイルパスと正確なライセンス文字列を記載してください。
- 互換性に関する主張は、**GPL 互換ライセンス(簡易版)**と照合し、判断が難しいライセンスはエスカレーションしてください。
- ヘッダーの修正を推奨する場合は、以下の例にある
License:とLicense URI:の値を、そのまま両方提示してください。互換性の根拠として gpl-compliance.md にリンクし、単に対応する URI を追加するよう伝えるだけにしてはいけません。
失敗モード (ライセンス)
- ライセンスが明確に GPL 互換でない場合は、推測しないでください。GNU ライセンスリストを確認してください。
- デュアルライセンスのパッケージでは、両方のライセンスと再配布条件を確認してください。
クイックリファレンス: WordPress の GPL 要件
- WordPress は GPLv2 以降です。
- WordPress.org で配布されるプラグインは、100% GPL 互換 (コードとアセット) でなければなりません。
- メインプラグインファイルに有効な
License:ヘッダーとLicense URI:を含めてください。 - GPL の自由と矛盾する制限を追加しないでください。
有効なライセンスヘッダー
GPL バージョンの概要
| バージョン | 年 | 主な追加点 |
|---|---|---|
| GPLv1 | 1989 | 基本的なコピーレフト: 改変に対する継承 (share-alike) |
| GPLv2 | 1991 | 「自由か死か」条項 (第 7 条)、より明確な配布条件 |
| GPLv3 | 2007 | 反 Tivo 化、明示的な特許許諾、互換性規定 |
WordPress は GPLv2 以降を使用しており、プラグインは GPLv2、GPLv3、または「GPLv2 以降」を使用できます。
完全なライセンス文については、以下を参照してください:
ライセンスコンプライアンスチェックリスト
プラグインをレビューする際は、以下を確認してください:
- メインプラグインファイルに有効な
License:ヘッダーがある (例:GPL-2.0-or-later、GPL-2.0+、GPLv2 or later) - メインプラグインファイルに、GPL の全文を指す
License URI:ヘッダーがある - バンドルされたライブラリが存在する場合、それぞれが GPL 互換ライセンスである
- 「分割ライセンス」がない (例: コードは GPL だが、プレミアム機能はプロプライエタリ)
- GPL が認める範囲を超える追加の制限がない
- 商用利用、改変、再配布を制限する条項がない
- 難読化されたコードがない (ソースコードの入手可能性という精神に違反)
WordPress プラグインの有効なライセンスヘッダー
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
GPL 互換ライセンス (クイック)
- 安全なデフォルト: GPL-2.0-or-later、GPL-3.0-or-later。
- 一般に受け入れられている寛容なライセンスファミリー: MIT/Expat、BSD、ISC、zlib、Boost。
- 条件付きの互換性には注意が必要: Apache-2.0 および MPL-2.0 (使用状況を確認してください)。
- 受け入れられる識別子と拒否される識別子の完全なリストについては、gpl-compliance.md を使用してください。
一般的な GPL 違反 (クイック)
- 配布されるコードを制限する分割ライセンス。
- 難読化された、または対応するソースが提供されない配布。
- 制限的な条項 (非商用、再販禁止、強制的なバックリンク)。
- GPL 非互換のライブラリやアセットのバンドル。
プラグインの命名規則 (ガイドライン 17)
商標の完全なリスト、slug のブロック、命名例については、naming-rules.md を使用してください。このインラインチェックリストはクイックスクリーニング用に保持してください。
命名レビューでは、ガイドライン 17 を引用し、該当する商標またはブロックされた slug のルールを説明し、リファレンスにリンクしてください。代替案を提案する場合は、名前と slug の両方を提示し、小文字、ハイフン区切り、50 文字の制限を明示的に確認してください。
命名チェックリスト (クイック)
- 名前がプレースホルダーではなく、少なくとも 5 文字の英数字を含んでいる。
- ヘッダーの名前と readme の名前が一致している。
- 名前が具体的で機能に関連しており、キーワードの詰め込みを避けている。
- 商標/プロジェクト名は、
for、with、using、andのような接続詞の後にのみ現れる。 - 禁止または非推奨の用語や、商標のかばん語がない。
- slug が小文字でハイフン区切り、50 文字以下で、ブロックされた用語を避けている。