rhdh-plugin-wiring について
プラグインの実際のエクスポートを基に、RHDH のフロントエンド動的プラグイン用配線 YAML を生成するスキルです。Scalprum 名と import 名を確認し、ソース変更や設定の適用は別のスキルに委ねます。
主な機能
- 01成果物またはパッケージから Scalprum 名を特定
- 02プラグインソースのエクスポートを確認
- 03完全な配線 YAML を生成
- 04ルート、エンティティページ、拡張機能を設定
- 05配線できない配置を特定
活用シーン
- 01エクスポート済み拡張機能を RHDH に接続
- 02import 名と公開エクスポートを照合
- 03ルート、エンティティタブ、カードを設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/rhdh-plugin-wiringを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/entity-page.mdfrontend-wiring.mdwiring.md詳細
RHDH プラグインの配線
エクスポートされたフロントエンドの動的プラグインを RHDH の拡張ポイントに接続する設定を管理します。プラグインの実際のエクスポートを読み取り、RHDH と同じ方法で Scalprum 名を導き出し、すべての importName がプラグインの実際のエクスポートに対応する設定を出力します。
/rhdh-local との対象範囲
このスキルは、プラグインのソースから配線設定を生成します。/rhdh-local は、実行中のローカル RHDH インスタンスに設定を適用し、そのインスタンスでプラグインを有効化・無効化して、コンテナーを再起動します。YAML の作成はこちらで行い、インスタンスへの読み込みはそちらで行います。
まずはこちらから
- パッケージ名と
scalprumブロックの有無を確認するため、package.jsonを読みます。 - 拡張機能と公開エクスポートを確認するため、
src/plugin.tsまたはsrc/plugin.tsxとsrc/index.tsを読みます。 - プラグインがエクスポート済みの場合は、
dist-dynamic/dist-scalprum/plugin-manifest.jsonを読みます。nameフィールドが Scalprum 名の正しい値です。 - 設定を生成する前に、見つかったエクスポートを報告します。
結果に応じて進む
| 結果 | 読み込んで従うもの |
|---|---|
| フロントエンドプラグインの配線を生成する | references/wiring.md |
| 特定の配線オプションを詳しく設定する | references/frontend-wiring.md |
| カタログエンティティページにコンテンツを配置する | references/entity-page.md |
references/frontend-wiring.md は完全なオプションリファレンスです。動的ルート、マウントポイントとその設定、エンティティタブとカード、検索結果の型、テーマ、Scaffolder のフィールド拡張、API ファクトリー、ルートバインディングを扱います。references/entity-page.md は、エンティティページの構造そのもの、つまりデフォルトタブ、カードの配置、コンテキストメニュー項目、コンテキストプロバイダーを扱います。
境界
- このスキルは設定を出力します。プラグインのソースやエクスポート成果物を変更したり、RHDH を実行したりはしません。
- プラグインのソースは
/rhdh-plugin-authoringが担当します。必要なimportNameが存在しない場合、修正すべきなのは設定ではなく、そちらです。 - 成果物とその
plugin-manifest.jsonの生成は/rhdh-plugin-exportが担当します。 - レガシーなマウントポイントを New Frontend System の拡張機能に変換するのは
/rhdh-plugin-nfs-migrationが担当します。このスキルでは、RHDH が現在読み込むレガシーな動的プラグイン設定を記述します。 - 設定の適用とインスタンスの再起動は
/rhdh-localが担当します。 - 公開済みプラグインのカタログメタデータは
/rhdh-overlayが担当します。
スキル名を指定して呼び出し、会話の中で引き継ぎ内容を説明します。他のスキルのファイルは開かないでください。
不変条件
- Scalprum 名は、デプロイされた成果物と完全に一致する必要があります。
plugin-manifest.jsonを優先し、次にpackage.jsonのscalprum.nameを使い、それらがない場合に限りパッケージ名から導き出します。 - すべての
importNameは実在するエクスポートを指定する必要があります。命名規則を当てにせず、src/index.tsで確認してください。 - マウントポイントを作り出さないでください。対象となる RHDH バージョンで定義されているものを使用し、要求された配置にマウントポイントがない場合はその旨を伝えてください。
- そのまま実行できる完全な YAML を出力します。ユーザーが組み立て直す必要のある断片は、プラグインをインストールしても表示されない問題の最も一般的な原因です。
- 設定だけでは何も変わりません。適用してインスタンスを再起動するまでは反映されません。変更に必要な再起動の種類を伝えてください。
完了
解決した Scalprum 名とその取得元、見つかったエクスポートとそれぞれに生成した設定項目、完全な YAML ブロック、配線できなかった要求配置とその理由、適用または公開のために次に呼び出すスキル名を報告します。