mcpField
R
rhdh-pr-create

rhdh-pr-create

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

关于 rhdh-pr-create

用于将已验证的 RHDH 变更发布为 GitHub Pull Request 的技能,可从暂存的检出内容或经过验证的交接开始。它负责发布流程而不实现产品代码,并要求每组外部写入都获得批准。

主要功能

  1. 01验证暂存变更或交接内容
  2. 02暂存并格式化获批文件
  3. 03运行发布检查并生成 changeset
  4. 04创建并推送 Pull Request
  5. 05上传录屏并更新关联 Issue

适用场景

  1. 01发布已验证的插件变更
  2. 02根据变更交接创建 Pull Request
  3. 03上传提供的前后录屏
  4. 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.yaml
references/
github-input.md
jira-input.md
repo-profiles.md
workflows/
create-pull-request.md

详细介绍

RHDH 拉取请求

实现通过验证后负责发布。接受当前已暂存的检出内容,或调用技能移交的变更;不要诊断或修改产品代码。

从这里开始

  1. 加载 references/repo-profiles.md,并从所有远程仓库中确定规范上游。
  2. 运行 gh auth status,并检查分支、状态、已暂存的差异和上游默认分支。
  3. 如果调用技能提供了变更移交,请根据检出内容验证其仓库和文件列表、问题引用、录屏及验证证据。以检出内容为准,并报告不匹配之处。
  4. 按顺序执行 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 结果,并报告失败的更新,不要将其隐瞒。

评论

支持 Markdown