关于 rhdh-plugin-wiring
用于根据插件实际导出内容生成 RHDH 前端动态插件接线 YAML 的技能。它核对 Scalprum 名称和导入名称;源码修改及应用配置由其他技能负责。
主要功能
- 01从制品或 package 推导 Scalprum 名称
- 02检查插件源码导出项
- 03生成完整接线 YAML
- 04配置路由、实体页和扩展
- 05指出无法接线的放置位置
适用场景
- 01将已导出的插件扩展接入 RHDH
- 02核对导入名称是否对应公开导出项
- 03配置路由、实体标签页或卡片
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-plugin-wiring安装后在 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 属于此技能;将其加载到实例中则属于 /rhdh-local。
从这里开始
- 读取
package.json,查看包名称和任何scalprum区块。 - 读取
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不存在,应在那里修复,而不是在配置中处理。/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