wordpress-router

wordpress-router スキルの概要

wordpress-router は、エージェントがリポジトリを素早く分類し、変更前に適切な下流ワークフローを選ぶための WordPress トリアージ用スキルです。ユーザーの依頼が広い範囲にまたがる場合や、コードベースが plugin、classic theme、block theme、Gutenberg package、WordPress core checkout、あるいは full site repo になり得る場合に特に役立ちます。

このスキルの用途

wordpress-router スキルは、編集ではなくルーティングのためのものです。リポジトリの種類、利用可能なツール、想定されるテスト、次に使うべき最も関連性の高い domain skill を特定し、初期の推測を減らすことが役割です。

どんな人が導入すべきか

WordPress のコードベースを日常的に扱い、リポジトリを blocks、theme.json、REST、WP-CLI、security、testing、release packaging のどれとして扱うべきかをエージェントに判断させたいなら、wordpress-router を導入してください。特に、複数の WordPress リポジトリをまたぐ Agent Orchestration で効果を発揮します。

なぜ重要なのか

router がないと、エージェントは誤った前提に飛びつきがちです。block theme に classic theme のロジックを当てはめたり、site repo に plugin 前提を持ち込んだり、WordPress に合ったワークフローではなく一般的な編集で進めてしまったりします。このスキルは、実務的な分類ステップを追加することで downstream の prompt 品質を高め、不要な変更のリスクを下げます。

wordpress-router スキルの使い方

インストールして判断経路を見つける

wordpress-router スキルの案内どおりにインストールしたら、まず SKILL.md を開いてください。リポジトリには references/decision-tree.md への案内もあり、ルーティング判断の次に読むべき最重要ドキュメントです。

スキルに正しい入力を与える

wordpress-router スキルは、次の情報を与えると最もよく機能します。

• リポジトリのルート、または現在の作業ディレクトリ
• ユーザーの実際の意図
• WordPress 対象バージョンや WP.com 要件などのバージョン制約
• ツール、リリース手順、テストに関する厳しい制限

「この WordPress repo を直して」のような弱い依頼だと、適切にルーティングしづらくなります。より強い依頼は例えば次のようになります。「これは wp-content repo です。block theme と plugin のどちらとして扱うべきかを判断し、既存テストを前提に template 変更の最も安全な進め方を計画してください。」

初回利用時の推奨ワークフロー

1. SKILL.md に記載された project triage の手順を実行します。
2. triage の結果を読み、project kind、ツール、テストカバレッジを把握します。
3. references/decision-tree.md を開き、意図を次のワークフローへ対応付けます。
4. 編集前に、既存の build コマンドや test コマンドを含むリポジトリ規約を確認します。

まずリポジトリ内で確認すべきもの

wordpress-router のガイドでは、次を優先してください。

• ルーティング手順とガードレールのための SKILL.md
• 意図ベースのルーティングのための references/decision-tree.md
• project kind が分かってから読む repo 固有ドキュメント

この順番が重要なのは、スキルの設計自体が、他の情報を総当たりで見る前に経路を絞り込むことを目的としているからです。

wordpress-router スキル FAQ

wordpress-router は domain skill の代替ですか？

いいえ。これは Agent Orchestration のためのフロントエンド判断スキルです。適切な WordPress ワークフローを選ぶ助けにはなりますが、リポジトリの分類後に必要になる block、theme、plugin、testing の各スキルを置き換えるものではありません。

どんなときに wordpress-router を使わないべきですか？

すでに範囲が狭く、明白なタスクでは使わなくてかまいません。たとえば、明確に特定されたワークフローの中で、既知の単一ファイルを編集するだけなら不要です。ルーティングのあいまいさがない場合は価値が下がります。

初心者にも wordpress-router の導入価値はありますか？

複数の WordPress repo type をまたいで作業する可能性がある初心者なら、はい。汎用的な prompt より安全な出発点になりますが、それでも意図と制約は明確に伝える必要があります。

通常の prompt と比べて何が違いますか？

通常の prompt は「何を変更するか」を尋ねるだけかもしれませんが、wordpress-router はまず「どの種類の WordPress system なのか」「変更をどの workflow が支配すべきか」を確認します。この追加の分類ステップこそが、wordpress-router スキルの大きな強みです。

wordpress-router スキルを改善するには

タスクだけでなく、意図を明確に伝える

最もよい入力は、望む結果と repo の文脈の両方を示します。たとえば「速くして」ではなく、「これは WordPress plugin repo です。performance work を plugin、REST、block のどの workflow に沿って進めるべきか判断し、最も安全な開始点を提案してください」と書くと効果的です。

ルーティングに影響する制約を追加する

WordPress の対象バージョン、リリース要件、ツールの制限を含めると、よりうまく機能します。こうした情報があると、その repo を core、site、theme、plugin、または Gutenberg-oriented work のどれとして扱うべきか判断しやすくなります。

よくある失敗パターンに注意する

最も多い問題は、文脈が不十分なことです。block theme、classic theme、plugin、site repo のどれを扱っているのか判断できなければ、次の workflow がずれてしまいます。もう1つの失敗パターンは、decision tree を飛ばしてそのまま編集に入ることです。

最初の分類後に反復する

最初の判定が終わったら、エージェントに次を言い直させてください。

• repo kind
• 想定される下流スキル
• 判断に使った files
• まだ残っている主な不確実性

こうすると、コード変更に入る前にルートを修正できるため、Agent Orchestration における wordpress-router の価値がさらに高まります。