mcpField
R
rhdh-plugin-wiring

rhdh-plugin-wiring

github.com/redhat-developer开发1944 次安装1 天前更新
代码仓库

关于 rhdh-plugin-wiring

用于根据插件实际导出内容生成 RHDH 前端动态插件接线 YAML 的技能。它核对 Scalprum 名称和导入名称;源码修改及应用配置由其他技能负责。

主要功能

  1. 01从制品或 package 推导 Scalprum 名称
  2. 02检查插件源码导出项
  3. 03生成完整接线 YAML
  4. 04配置路由、实体页和扩展
  5. 05指出无法接线的放置位置

适用场景

  1. 01将已导出的插件扩展接入 RHDH
  2. 02核对导入名称是否对应公开导出项
  3. 03配置路由、实体标签页或卡片

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/redhat-developer/rhdh-skills --skill rhdh-plugin-wiring

安装后在 Claude Code 中输入/rhdh-plugin-wiring确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
entity-page.md
frontend-wiring.md
wiring.md

详细介绍

RHDH 插件接线配置

负责管理将已导出的前端动态插件连接到 RHDH 扩展点的配置。读取插件的实际导出项,按照 RHDH 的相同方式推导 Scalprum 名称,并生成配置,确保每个 importName 都对应插件实际导出的内容。

与 /rhdh-local 的职责范围

此技能根据插件源代码生成接线配置。/rhdh-local 应用配置到正在运行的本地 RHDH 实例、在其中启用和停用插件,并重启容器。生成 YAML 属于此技能;将其加载到实例中则属于 /rhdh-local。

从这里开始

  1. 读取 package.json,查看包名称和任何 scalprum 区块。
  2. 读取 src/plugin.ts 或 src/plugin.tsx 以及 src/index.ts,查看扩展和公共导出项。
  3. 如果插件已导出,则读取 dist-dynamic/dist-scalprum/plugin-manifest.json;其 name 字段是权威的 Scalprum 名称。
  4. 生成配置前,先报告找到的导出项。

根据结果选择路径

结果加载并遵循
为前端插件生成接线配置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 不存在,应在那里修复,而不是在配置中处理。
  • /rhdh-plugin-export 负责生成制品及其 plugin-manifest.json。
  • /rhdh-plugin-nfs-migration 负责将旧版挂载点转换为 New Frontend System 扩展。此技能编写 RHDH 当前使用的旧版动态插件配置。
  • /rhdh-local 负责应用配置并重启实例。
  • /rhdh-overlay 负责已发布插件的目录元数据。

调用具名技能,并在对话中说明交接内容。切勿打开其他技能的文件。

不变量

  • Scalprum 名称必须与已部署的制品完全一致。优先使用 plugin-manifest.json,其次使用 package.json 中的 scalprum.name,最后才根据包名称推导。
  • 每个 importName 都必须对应一个真实导出项。请对照 src/index.ts 验证,不能想当然地套用命名规则。
  • 不要臆造挂载点。只能使用目标 RHDH 版本定义的挂载点;如果请求的放置位置没有对应挂载点,请明确说明。
  • 输出完整且可运行的 YAML。要求用户自行重新拼接的片段,是插件安装后无法渲染的最常见原因。
  • 仅有配置不会产生任何变化,必须应用配置并重启实例。请说明需要哪种重启。

完成

报告已确定的 Scalprum 名称及其来源、找到的导出项及其各自生成的配置条目、完整 YAML 区块、无法接线的任何请求放置位置及其原因,以及下一步应调用哪个具名技能来应用或发布配置。

评论

支持 Markdown