wp-plugin-development

wp-plugin-development の概要

wp-plugin-development は、WordPress に特化したスキルで、プラグインの作成・リファクタリング・堅牢化を、一般的なプロンプトよりも少ない推測で進められるようにします。プラグインのアーキテクチャ、hooks、有効化/無効化/削除時の挙動、管理画面の設定、データ保存、cron ジョブ、セキュリティ上注意が必要なコードパスを扱う人に特に向いています。

この skill が向いている作業

wp-plugin-development skill を使うのは、単に「PHP を書く」ではなく、「このプラグインを WordPress の中で正しく動かす」必要があるときです。たとえば、bootstrap ファイルをどこに置くべきか、hooks をどう登録するか、設定を安全に保存する方法は何か、ライフサイクルイベントで何をすべきか、といった進行を止めがちな判断を助けます。

向いているユーザーとプロジェクト

この skill は、単体プラグインのバックエンド開発、より大きな WordPress リポジトリ内のプラグインモジュール、既存コードベースの保守作業に適しています。特に、独自フレームワークを勝手に作るのではなく、WordPress の慣習を尊重する wp-plugin-development ガイドが必要なときに役立ちます。

何が違うのか

最大の価値はワークフローの規律です。コードを変える前に、プラグインのエントリポイント、ライフサイクルルール、セキュリティ上のガードレール、参照すべき補助ファイルへ先に案内します。そのため wp-plugin-development は、その場しのぎの一発プロンプトより実用的です。正しい順序でインストール、確認、実装を進める前提で設計されているからです。

wp-plugin-development skill の使い方

インストールして対象プラグインを確認する

編集しているリポジトリの文脈で、wp-plugin-development のインストールコマンドを使います。

npx skills add WordPress/agent-skills --skill wp-plugin-development

インストール後は、どのプラグインを触るのかを必ず確認してください。サイト全体のリポジトリでは、編集前に wp-content/plugins/ または mu-plugins/ の中から正しいプラグインを特定します。ここは最もありがちな失敗ポイントのひとつです。

skill に最初に必要な情報を渡す

この skill は、リポジトリのルート、分かっていればプラグインのパスまたはメインファイル、WordPress/PHP のバージョン、単一サイトかマルチサイトか、を伝えると最もよく機能します。目的が WP-CLI やリリース用パッケージングに依存するなら、それも先に明示してください。これらの情報は API の選択、互換性、提案した修正を安全に適用できるかどうかに影響します。

作業内容を明確に名指ししたプロンプトを使う

強い入力は広すぎず、具体的です。たとえば、次のように書きます。

• “Refactor the plugin bootstrap so admin-only hooks are loaded lazily.”
• “Add a settings page with sanitization, capabilities, and saved defaults.”
• “Fix the activation routine so rewrite rules are flushed only after registration.”
• “Audit this plugin for nonce, escaping, and SQL safety issues.”

こうしたプロンプトは、構造、ライフサイクル、設定、セキュリティのどれを扱うべきかを wp-plugin-development skill が見極めやすくします。

先に読むべきファイル

まず SKILL.md を読み、その後で references/structure.md、references/lifecycle.md、references/settings-api.md、references/security.md、references/data-and-cron.md、references/debugging.md を確認してください。リポジトリに含まれている場合は、scripts/detect_plugins.mjs を実行すると plugin headers を素早く見つけられます。この順番なら、インストールから有用な出力まで最短で進めます。

wp-plugin-development skill の FAQ

wp-plugin-development は新規プラグイン専用ですか？

いいえ。既存プラグインのリファクタリング、バグ修正、整理にも同じくらい有効です。実際の wp-plugin-development の利用ケースの多くは、すでにあるコードの hook のタイミング、ライフサイクル動作、セキュリティ上のミスを直すことにあります。

いつこの skill を使うべきではありませんか？

WordPress プラグインのコードを変えないなら、使わないでください。一般的な PHP ライブラリ、テーマだけの作業、プラグインの挙動に関係しない UI コピーの修正には向きません。WordPress プラグインのバックエンド開発以外の作業なら、助言が細かすぎます。

通常のプロンプトより優れていますか？

はい、WordPress 固有の判断が必要な作業ではそうです。通常のプロンプトでも動く PHP は出せるかもしれませんが、wp-plugin-development skill は bootstrap 構成、activation hooks、Settings API の使い方、sanitization/escaping にガードレールを加えるので、よりデプロイしやすい結果になります。

初心者でも使いやすいですか？

はい。プラグインの目的と、変更したいファイルを説明できるなら十分です。初心者にとっては、コードを編集する前に「最初に何を確認すべきか」を示す file-reading の流れが特に役立ちます。

wp-plugin-development skill を改善するには

機能だけでなく、実際の制約を伝える

結果を最も速く改善する方法は、本当に重要な制約を入れることです。たとえば、互換性のバージョン、マルチサイトでの挙動、すでに公開済みかどうか、最小限のパッチが必要か、それとも整理を伴うリファクタリングか、といった情報です。そうすると wp-plugin-development skill は、理屈としては正しくても、あなたのリリースには合わない変更案を避けやすくなります。

プラグインの現状の形を見せる

より良いコード変更を得たいなら、メインのプラグインファイル、関連する class 名、現在の hook の流れを共有してください。たとえば、「bootstrap は my-plugin.php にあり、admin code は常時読み込まれ、settings は 1 つの option array に保存されている」といった情報です。これで skill は、新しい構成を勝手に作るのではなく、既存リポジトリに合う構造を提案しやすくなります。

実際に適用できる出力を求める

良い依頼は、何を返してほしいかを明示しています。たとえば、patch plan、ファイルごとの編集戦略、セキュリティレビュー、リリースチェックリストです。特定の成果物に向けた wp-plugin-development ガイドが必要なら、「安全な最小変更」がほしいのか、「破壊的変更の影響も見たうえで、よりきれいな構成」にしたいのかを伝えてください。

症状から修正へ段階的に絞り込む

最初の回答が広すぎるなら、失敗の型に絞り込みます。たとえば、「activation hook が動かない」「settings が保存されない」「cron が 2 回走る」「nonce チェックは通るが権限確認が抜けている」などです。もっとも有益な改善ループは、症状 → 関連する参照ファイル → コード変更 → 再確認、という流れです。これにより、実際に導入を妨げているプラグイン部分に skill を集中させ続けられます。