SuperAPI AI 工具集

create-pull-request

通用与其它

查看项目

更新于 10-15 20:33

技能介绍

用途:在用户要求创建 PR、提交变更供审查或打开拉取请求时,引导生成结构清晰、符合项目规范的 GitHub PR。

主要能力与流程:

  1. 前置检查:用 gh --version 确认已安装 GitHub CLI(未装提示 macOS 用 brew install gh,其他平台见 https://cli.github.com/);用 gh auth status 检查登录;查找描述含 review、CI/ci-fix、testing/test 的相关技能,若有应先调用;用 git status 确认工作区干净,未提交改动需询问提交、暂存或丢弃。
  2. 检查已有 PR:gh pr list --head $(git branch --show-current) --json number,title,url,已存在则展示并询问查看、更新或关闭。
  3. 收集上下文:git branch --show-current 确认不在 main/master;git remote show origin | grep "HEAD branch" 找基础分支;git log origin/main..HEAD --oneline --no-decorate 与 git diff origin/main..HEAD --stat 分析改动、范围与文件类型;从提交信息、分支名提取 issue 编号(如 #123、fixes #123)与变更类型、测试说明。
  4. 生成标题:项目用约定式提交时套用 feat/fix/docs/refactor/test/chore 等前缀,否则写面向动作的描述性标题,避免 initial commit、fix、update 等泛化标题,可附加 issue 编号。
  5. 提交规范建议:原子提交、清晰信息、优先 rebase;必要时 git fetch origin 与 git rebase origin/main,如提交零碎可考虑 git rebase -i origin/main(仅在用户熟悉时建议);用 git push origin HEAD 推送,变基后可用 --force-with-lease。
  6. 创建 PR:若存在 .github/pull_request_template.md 须按其结构填写 body,包含变更摘要、关联 issue、测试情况与破坏性影响,勾选类型与清单项;随后执行 gh pr create --title "PR_TITLE" --body "PR_BODY" --base main(草稿加 --draft)。未完成、测试失败、需早期反馈或阻塞于设计决策时用草稿;测试通过且待审查用普通 PR。
  7. 创建后:gh pr view --web 打开浏览器核对标题、描述、链接与 diff;必要时用 gh pr edit --add-reviewer USERNAME、gh pr edit --add-label "bug" 添加审查者或标签;提醒 CI 与 lint 会自动运行。

错误处理:分支无领先 main 的提交、远程未推送分支、PR 已存在、与基础分支冲突等情况均有对应提示。

限制:依赖 gh CLI 与 GitHub 仓库环境;技能本身不替代代码审查、CI 修复和测试;关于收费、价格、具体平台支持范围等资料未提供。