mcpField
R
rhdh-plugin-export

rhdh-plugin-export

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

关于 rhdh-plugin-export

该技能用于在插件工作区中导出正在开发的插件,生成可部署制品。它指导构建、打包为 OCI 镜像、tgz 归档或 npm 包,并可发布到注册表及处理完整性信息。

主要功能

  1. 01检查插件构建和 TypeScript 编译
  2. 02将插件导出到 dist-dynamic/
  3. 03打包为 OCI 镜像、tgz 或 npm 包
  4. 04选择共享、内嵌或捆绑依赖
  5. 05生成或验证完整性值

适用场景

  1. 01为部署打包本地开发的插件
  2. 02将导出的制品发布到注册表
  3. 03准备动态插件接线所需的制品引用

安装

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

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

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

包含的文件

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

agents/
openai.yaml
examples/
dynamic-plugins.yaml
references/
export-options.md
export.md
integrity-hashes.md
packaging-formats.md
scripts/
export-plugin.py

详细介绍

RHDH 插件导出

负责从可用源码到可部署制品的环节。插件完成构建后会导出到 dist-dynamic/,打包为三种格式之一,还可以选择发布到注册表,并提供部署可固定使用的完整性值。

与 /rhdh-overlay 的范围划分

此技能从插件自己的工作区,在你的机器上导出你正在开发的插件。/rhdh-overlay 修复的是覆盖仓库的 CI 导出——包括 source.json、plugins-list.yaml,以及 rhdh-plugin-export-overlays 为扩展目录运行的导出任务。如果失败的导出是该仓库中的 GitHub Actions 运行任务,则不属于此技能的范围。

从这里开始

  1. 确认插件能够构建:在插件目录中运行 yarn build 和 yarn tsc。
  2. 阅读 package.json,了解插件的角色、名称和版本;并检查后端插件是否从 src/index.ts 默认导出。
  3. 运行任何操作前,先确定目标格式: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