SuperAPI AI 工具集

pull-request

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:在任意以 GitHub 为远程仓库的 Git 仓库中,为当前分支创建 Pull Request。该技能仅在用户主动要求时运行,不会在提交后自动触发,且只创建 PR,不执行合并。

主要能力与流程: 一、就绪检查。用 git log <base>..HEAD 确认当前分支是否有领先基线分支的提交;若无提交则告知无需创建并停止。若当前分支未推送,使用 git push -u origin <branch> 推送并建立跟踪。再用 gh pr view 检查是否已存在 PR,若存在则显示其 URL,并询问用户是更新还是中止。 二、起草与创建。显示提交日志 git log --oneline <base>..HEAD 和完整差异 git diff <base>...HEAD,据此起草标题与正文:标题使用命令式、简短概括,控制在 72 字符以内;正文为结构化摘要并适当分段,若有近期 PR 可参考仓库惯例。创建命令为 gh pr create --title "<title>" --body "$(cat <<'EOF'\n<body>\nEOF\n)"。完成后显示 PR 编号与 URL。

错误处理与收尾:若创建失败,显示 gh pr create 返回的错误信息。创建后以审查者视角复核:标题与正文能否让缺乏上下文的人理解改了什么、为什么改;差异是否包含全部预期改动,并通过 git status 检查是否有遗漏的未暂存更改。

限制:不合并 PR;除非用户明确要求,否则不强制推送或变基;基线分支默认为仓库默认分支,用户可另行指定。