SuperAPI AI 工具集

github-pr-merge

编程与开发

查看项目

更新于 11-12 17:16

技能介绍

用途

github-pr-merge 是一个面向 GitHub Pull Request 合并流程的技能,在用户要求合并 PR、关闭 PR、完成 PR,或提到“PR 머지/병합”时使用。该技能声明会覆盖默认的 PR 合并行为,在合并前执行校验,并在合并后完成清理。

主要能力

  • 识别 PR 与仓库:通过 gh 命令行获取当前 PR 编号与仓库全名。
  • 合并前检查清单:要求测试通过(make test)、lint 通过(make lint)、CI 检查为绿色(gh pr checks)、所有评论均已回复、没有未解决的讨论线程。
  • 评论回复状态检查:通过 GitHub API 统计原始评论数量与已有回复的评论数量;若存在未回复评论,则停止合并流程,并提示用户先运行 pr-review。
  • 展示 PR 摘要:合并前展示标题、提交数量与变更文件数。
  • 用户确认:执行合并前必须向用户确认。
  • 执行合并:使用 gh pr merge 以 merge commit 方式合并,并删除远端分支;合并信息采用简明格式,包含变更要点、评审处理情况、测试结果与任务引用。
  • 合并后清理:切回 develop、拉取最新代码并删除本地特性分支。

使用方式

技能以命令行工作流形式给出,主要依赖 gh 与 make 等工具,步骤包括:获取 PR 信息、运行合并前检查清单、检查评论回复状态、运行校验、展示 PR 摘要、与用户确认、执行合并、合并后清理。命令示例包括:

PR=$(gh pr view --json number -q '.number')
REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')
make test && make lint && gh pr checks $PR
gh pr merge $PR --merge --delete-branch --body "..."
git checkout develop && git pull && git branch -d feature/

适用场景

适用于需要在合并 GitHub PR 前强制完成测试、lint、CI 与评论回复检查的团队工作流,尤其是使用 develop 分支与特性分支模型的仓库。

规则与限制

  • 合并前必须运行完整的合并前检查清单。
  • 必须确认所有评审评论均有回复;存在未回复评论时停止合并。
  • 执行合并前必须与用户确认。
  • 必须使用 merge commit(--merge),不使用 squash 或 rebase。
  • 合并成功后必须删除特性分支。
  • 测试或 lint 失败时不得合并;CI 检查未通过时不得合并。
  • 该技能不负责回复 PR 评论,应使用 pr-review。
  • 涉及分支保护时,提示所需的审批要求。
  • 工具的具体安装方式、支持的平台范围、收费与价格信息暂未提供。