wordpress-router について
wordpress-routerは、WordPressリポジトリの種類を判別し、適切なワークフローへタスクを振り分けるスキルです。利用可能なツールやテストを確認し、リポジトリの慣例とバージョン制約に沿って進めます。
主な機能
- 01WordPressプロジェクトの分類
- 02ツールとテストの検出
- 03意図に応じたワークフロー振り分け
- 04バージョンとリポジトリ制約の確認
- 05大きな変更後の再トリアージ
活用シーン
- 01WordPressプラグインやテーマの作業手順選定
- 02利用可能なビルド・テストツールの確認
- 03ブロックやサイト作業の専門スキルへの振り分け
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ automattic/ agent-skills --skill wordpress-routerインストール後、Claude Code で/wordpress-routerを入力して読み込まれたか確認します。
同梱ファイルreferences/decision-tree.md
詳細
WordPress ルーター
使用するタイミング
ほとんどの WordPress タスクの開始時にこのスキルを使用して、次のことを行います。
- どのような種類の WordPress コードベースか(プラグイン、テーマ、ブロックテーマ、WP コアのチェックアウト、サイト全体)を特定します。
- 適切なワークフローとガードレールを選びます。
- 最も関連性の高いドメインスキルに委任します。
必要な入力
- リポジトリのルート(現在の作業ディレクトリ)。
- ユーザーの意図(変更したい内容)と制約事項(対象とする WP のバージョン、WP.com 固有の要件、リリース要件)。
手順
- プロジェクトのトリアージスクリプトを実行します。
node skills/wp-project-triage/scripts/detect_wp_project.mjs
- トリアージの出力を確認し、次の項目を分類します。
- 主なプロジェクトの種類。
- 利用可能なツール(PHP/Composer、Node、@wordpress/scripts)。
- 存在するテスト(PHPUnit、Playwright、wp-env)。
- バージョンに関する手掛かり。
- ユーザーの意図とリポジトリの種類に基づいて、ドメインのワークフローに振り分けます。
- 判断ツリーについては、
skills/wordpress-router/references/decision-tree.mdを読みます。
- 判断ツリーについては、
- 変更を加える前にガードレールを適用します。
- 不明な場合は、バージョンの制約を確認します。
- ビルドやテストには、リポジトリで既に使われているツールや規約を優先します。
検証
- 重要なファイルを新規作成したり、構成を変更したりした場合は、トリアージスクリプトを再実行します。
- 利用可能な場合は、トリアージの出力で推奨されているリポジトリのリンター、テスト、ビルドのコマンドを実行します。
失敗時の対応/デバッグ
- トリアージの結果が
kind: unknownの場合は、次のファイルやディレクトリを確認します。- ルートにある
composer.json、package.json、style.css、block.json、theme.json、wp-content/。
- ルートにある
- リポジトリが非常に大きい場合は、スキャン範囲を絞るか、トリアージスクリプトに除外ルールを追加することを検討します。
エスカレーション
- 振り分けが曖昧な場合は、次の質問を1つだけ尋ねます。
- 「これは WordPress プラグイン、テーマ(クラシック/ブロック)、それともサイト全体のリポジトリを想定していますか?」
コメント
Markdown 対応