SuperAPI AI 工具集

raise-pr

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

raise-pr 提供在 lightspeed-service 仓库中提交改动并开设 PR 的分步流程。

用途:把已暂存的改动安全地整理成 PR,尤其强调从 upstream/main 建新分支,避免 fork 的 origin/main 携带过期提交。

主要步骤:

  1. 分支检查:依次执行 git fetch upstream、git branch --show-current、git log --oneline upstream/main..HEAD、git diff upstream/main --stat、gh pr list --head "$(git branch --show-current)" --state open,向用户给出摘要并询问是否从 upstream/main 新建分支或沿用当前分支,未答复前不继续;新建分支使用 git fetch upstream 与 git checkout -b <type>/<short-description> upstream/main,必要时 cherry-pick 指定提交。
  2. 预提交检查:按顺序运行 make test-unit、make test-integration、make verify,失败需先修复;确认改动代码覆盖率保持 90% 以上。
  3. 提交与推送:若无 Jira 编号需先向用户索取;提交信息用简短祈使句,不加句点、不使用约定式前缀、不含 Jira ID;执行 git add -A(或仅相关文件)、git commit -m "<message>"、git push -u origin HEAD。
  4. 开设 PR:标题格式为 <JIRA-ID>: <与提交相同的简短祈使句>,读取并填写 .github/PULL_REQUEST_TEMPLATE.md 各节,包括改动说明、变更类型、关联工单与文档(如解决 GitHub issue 写 Closes #<github-issue>,并始终链接 Jira 工单,格式 https://issues.redhat.com/browse/)、检查清单和测试说明,最后用 gh pr create 提交,完成后把 PR URL 返回给用户。

适用场景:在 lightspeed-service 仓库中需要规范化地提交代码并发起 PR 时。

限制:工作流依赖 upstream 远端、gh CLI、make 目标等环境;强制要求用户确认分支选择并提供 Jira 编号;不覆盖其他仓库或不同分支策略。具体收费、平台支持等信息暂未提供。