关于 rhdh-plugin-export
该技能用于在插件工作区中导出正在开发的插件,生成可部署制品。它指导构建、打包为 OCI 镜像、tgz 归档或 npm 包,并可发布到注册表及处理完整性信息。
主要功能
- 01检查插件构建和 TypeScript 编译
- 02将插件导出到 dist-dynamic/
- 03打包为 OCI 镜像、tgz 或 npm 包
- 04选择共享、内嵌或捆绑依赖
- 05生成或验证完整性值
适用场景
- 01为部署打包本地开发的插件
- 02将导出的制品发布到注册表
- 03准备动态插件接线所需的制品引用
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-plugin-export安装后在 Claude Code 中输入/rhdh-plugin-export确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlexamples/dynamic-plugins.yamlreferences/export-options.mdexport.mdintegrity-hashes.mdpackaging-formats.mdscripts/export-plugin.py详细介绍
RHDH 插件导出
负责从可用源码到可部署制品的环节。插件完成构建后会导出到 dist-dynamic/,打包为三种格式之一,还可以选择发布到注册表,并提供部署可固定使用的完整性值。
与 /rhdh-overlay 的范围划分
此技能从插件自己的工作区,在你的机器上导出你正在开发的插件。/rhdh-overlay 修复的是覆盖仓库的 CI 导出——包括 source.json、plugins-list.yaml,以及 rhdh-plugin-export-overlays 为扩展目录运行的导出任务。如果失败的导出是该仓库中的 GitHub Actions 运行任务,则不属于此技能的范围。
从这里开始
- 确认插件能够构建:在插件目录中运行
yarn build和yarn tsc。 - 阅读
package.json,了解插件的角色、名称和版本;并检查后端插件是否从src/index.ts默认导出。 - 运行任何操作前,先确定目标格式:OCI 镜像、tgz 归档或 npm 包。
根据结果选择
| 结果 | 加载并遵循 |
|---|---|
| 一次性完成导出和打包 | references/export.md;运行 scripts/export-plugin.py |
| 选择共享、嵌入或捆绑依赖 | references/export-options.md |
| 比较或生成特定制品格式 | references/packaging-formats.md |
| 生成或验证完整性值 | references/integrity-hashes.md |
| 查看完整的部署配置 | examples/dynamic-plugins.yaml |
捆绑脚本涵盖常见操作路径:
python scripts/export-plugin.py --plugin-dir plugins/my-plugin \
--tag quay.io/ns/my-plugin:v0.1.0 --push --clean
运行时使用 --help 查看完整选项。如果脚本的默认设置不适用,请逐步遵循 references/export.md。
边界
- 此技能用于生成制品,不会编写插件源码、生成部署配置或运行 RHDH。
/rhdh-plugin-authoring负责插件源码,包括缺少默认导出或构建失败(此处会显现)的问题。/rhdh-plugin-wiring负责使用此技能生成的制品的dynamic-plugins.yaml配置。/rhdh-local负责将制品安装到正在运行的本地 RHDH 中。/rhdh-overlay负责覆盖仓库和扩展目录。
在对话中调用指定技能并说明交接内容。切勿打开其他技能的文件。
不变量
- 切勿臆造注册表引用。根据导出输出和注册表响应,确定包名称、标签和摘要。
- 推送到注册表属于外部写入。调用指定技能
mutation-gate并遵循其要求;操作目标必须是准确的注册表、仓库和标签。 - 部署需要稳定制品时,优先使用摘要而非标签。
- 按原样报告生成的路径和引用;部署若固定使用猜测的值,会在远离此处的安装阶段失败。
完成
报告运行的导出命令、制品格式及其准确引用或路径、共享依赖和嵌入依赖的处理决定、生成的任何完整性值、是否执行了推送及推送目标,以及接下来应调用哪个指定技能来完成配置或本地验证。
评论
支持 Markdown