关于 rhdh-pr-create
用于将已验证的 RHDH 变更发布为 GitHub Pull Request 的技能,可从暂存的检出内容或经过验证的交接开始。它负责发布流程而不实现产品代码,并要求每组外部写入都获得批准。
主要功能
- 01验证暂存变更或交接内容
- 02暂存并格式化获批文件
- 03运行发布检查并生成 changeset
- 04创建并推送 Pull Request
- 05上传录屏并更新关联 Issue
适用场景
- 01发布已验证的插件变更
- 02根据变更交接创建 Pull Request
- 03上传提供的前后录屏
- 04发布时更新关联的 GitHub Issue
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-pr-create安装后在 Claude Code 中输入/rhdh-pr-create确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/github-input.mdjira-input.mdrepo-profiles.mdworkflows/create-pull-request.md详细介绍
RHDH 拉取请求
实现通过验证后负责发布。接受当前已暂存的检出内容,或调用技能移交的变更;不要诊断或修改产品代码。
从这里开始
- 加载
references/repo-profiles.md,并从所有远程仓库中确定规范上游。 - 运行
gh auth status,并检查分支、状态、已暂存的差异和上游默认分支。 - 如果调用技能提供了变更移交,请根据检出内容验证其仓库和文件列表、问题引用、录屏及验证证据。以检出内容为准,并报告不匹配之处。
- 按顺序执行
workflows/create-pull-request.md。不提供自动批准模式:每项外部写入都必须完整说明,并且只能在获得对该组所述操作的批准后执行。
边界
- 此技能负责暂存、格式化、验证、创建变更集、提交、推送、创建 PR、上传提供的录屏,以及更新关联的 GitHub issue。Jira 读取由
/rhdh-jira-api负责,Jira 写入由/rhdh-jira-update负责。按名称调用其中任一技能并采用其报告内容;切勿在此处直接调用 Jira。 - GitHub issue 读取由
/rhdh-forge负责,该技能会返回相同的 issue 详情,并带有source: github。如果请求提供了 issue URL 或编号,请加载references/github-input.md。 - 此技能不会实现修复或功能。如果验证发现产品代码故障,请停止并将故障交回生成该变更的技能,通常是
/rhdh-plugin-bug-fix,并附上失败的命令及其输出。 - 预先存在的脏文件或未跟踪文件不属于发布范围,除非用户明确指出它们是此次变更的一部分。
- 只有已发布的插件源代码路径需要变更集;私有的
packages/*、开发应用、测试、测试夹具和故事均不需要。 - 切勿捏造 issue 数据、录屏 URL、CI 结果或审查者证据。
变更移交
生成了已验证变更的技能可以移交该变更,而不必将其留在暂存区;通常由 /rhdh-plugin-bug-fix 生成。移交内容会在对话中提供,并注明变更摘要、构成变更的文件列表、issue 引用、可选的变更前后录屏,以及已运行的验证和结果。
文件列表就是变更集。生成技能不会进行暂存,因此这些路径会处于未暂存或未跟踪状态:请根据工作树验证它们,将其排除在预先存在的基线之外,并在工作流的暂存关卡中,将它们与构建生成的文件一并且仅暂存这些文件。只有在未提供移交内容时,空索引才是停止条件。
未提供移交内容时,从已暂存的差异中推导这些字段,并且只询问尚未解决的 issue 上下文或发布意图。
外部写入
只读检查、构建和草拟内容不构成写入批准。推送、上传录屏、创建 PR 或更新 GitHub issue 都属于外部写入:调用指定技能 mutation-gate 并遵循其流程,不要在此处重述批准流程。
逐项说明此技能负责的每项写入,包括确切目标、确切命令和变更预览——git push、GitHub Contents 上传、拉取请求创建、GitHub issue 评论——针对所述操作集合获取批准,仅执行该集合,然后报告每项操作的结果,包括跳过的操作。只暂存已批准的路径;如果提供了移交内容,则这些路径必须取自移交中的文件列表。如果前一项操作生成了后续操作所需的材料(例如 PR 正文需要使用的已上传录屏 URL),请先报告第一组操作的结果,再说明并获取下一组操作的批准。拒绝不受支持的旧式 --a。每项结果报告还必须注明发生变更的资源或 URL、其验证情况,以及任何尚待执行的恢复操作。
完成
报告 PR URL、仓库、头部分支和提交 SHA、生成的 changeset、提供录制内容时上传的录制 URL、每项问题更新,以及每项外部写入的结果。URL 和 SHA 必须直接取自命令输出,不要自行拼凑。只有在已获取 PR URL,且所要求的上传关卡均已成功或已报告需人工处理后,创建的 PR 才算完成。如果外部更新失败,请保留成功的 PR 结果,并报告失败的更新,不要将其隐瞒。