SuperAPI AI 工具集

rhdh-pr-create

编程与开发

查看项目

更新于 10-16 02:25

技能介绍

用途

RHDH Pull Request 技能用于在实现验证完成后负责发布流程。它接受当前已暂存的检出内容,或来自调用技能(通常是 /rhdh-plugin-bug-fix)的变更交接,不负责诊断或修改产品代码。

主要能力

  • 检测仓库与受影响的工作区,识别规范上游仓库。
  • 运行仓库构建流水线。
  • 生成 changeset(仅已发布的插件源码路径需要,私有 packages/*、开发应用、测试、fixtures 和 stories 不需要)。
  • 暂存、格式化、验证、提交、推送代码。
  • 创建拉取请求。
  • 上传提供的录制文件。
  • 更新关联的 GitHub issue。

使用方式

  1. 加载 references/repo-profiles.md,从所有远程中识别规范上游。
  2. 运行 gh auth status,检查分支、状态、暂存差异和上游默认分支。
  3. 若调用技能提供了变更交接,需对照检出内容验证其仓库与文件列表、issue 引用、录制文件和验证证据;以检出内容为准并报告不匹配。
  4. 按顺序执行 workflows/create-pull-request.md。没有自动批准模式:每次外部写入都需完整声明并在运行前获得批准。

变更交接包含变更摘要、构成变更的文件列表、issue 引用、可选的变更前后录制文件,以及已运行的验证及其结果。文件列表即变更集;产生技能不暂存,因此这些路径以未暂存或未跟踪状态到达,需对照工作树验证,排除在既有基线之外,并在工作流的暂存门处与构建生成文件一起精确暂存。仅当未提供交接时,空索引才是停止条件。未提供交接时,从暂存差异中推导这些字段,仅询问未解决的 issue 上下文或发布意图。

边界与限制

  • 不实现修复或功能。若验证暴露产品代码失败,停止并将失败(含失败命令及其输出)交回产生变更的技能,通常是 /rhdh-plugin-bug-fix。
  • Jira 读取属于 /rhdh-jira-api,Jira 写入属于 /rhdh-jira-update;按名称调用并消费其报告,绝不直接调用 Jira。
  • GitHub issue 读取属于 /rhdh-forge,返回相同 issue 详情并标注 source: github。当请求提供 issue URL 或编号时,加载 references/github-input.md。
  • 预先存在的脏文件或未跟踪文件不属于发布集,除非用户明确将其标识为变更的一部分。
  • 绝不捏造 issue 数据、录制 URL、CI 结果或审查者证据。
  • 拒绝不支持的旧式 --a。

外部写入

只读检查、构建和草稿构建不批准写入。推送、录制上传、PR 创建或 GitHub issue 更新属于外部写入:调用指定的技能变更门并遵循它。需声明本技能拥有的每次写入及其确切目标、确切命令和变更预览(git push、GitHub Contents 上传、拉取请求创建、GitHub issue 评论),获得对该声明集合的批准,仅执行该集合,然后报告每个操作的结果,包括被跳过的操作。精确暂存已批准的路径(有交接时取自交接的文件列表)。若较早操作产生后续操作所需的材料(如上传的录制 URL 用于 PR 正文),先报告第一组结果,再声明并获取下一组的批准。每个报告的结果还需注明更改的资源或 URL、其验证以及任何剩余的恢复操作。

完成

报告 PR URL、仓库、头分支与提交 SHA、生成的 changeset、上传的录制 URL(当提供录制时)、每次 issue 更新以及每次外部写入的结果。确切 URL 和 SHA 取自命令输出而非重建。创建的 PR 在捕获其 URL 且请求的上传门已成功或已报告需手动操作之前不算完成。若外部更新失败,保留成功的 PR 结果并报告失败的更新,而非隐藏它。