用途
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。
- 涉及分支保护时,提示所需的审批要求。
- 工具的具体安装方式、支持的平台范围、收费与价格信息暂未提供。