SuperAPI AI 工具集

pr

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

PR 是一个围绕 Git 与 GitHub 工作流设计的技能,用于把本地代码变更提交、推送,并自动创建新的拉取请求(PR)或追加到已有的 PR 上。它根据分支状态自动判断采用哪种模式,减少手动操作。

用途 该技能面向需要走 PR 流程提交代码的场景。它把「提交本地变更、推送到远端、创建或追加 PR」这一系列步骤整合起来,并自动检测当前分支是否已有打开的 PR,从而决定是新建还是追加。

主要能力

  • 自动检测当前分支与远端默认分支,判断应新建 PR 还是追加到已有 PR。
  • 暂存变更并生成提交信息,遵循项目既有的提交约定;若无约定,则默认使用不超过 120 字符、以句号结尾的简洁英文信息,聚焦用户可感知的变更。
  • 生成 PR 元数据,包括分支名、PR 标题与 PR 描述。分支名在默认分支上时按项目命名约定生成,否则使用 feature/{username}_topic 或 bugfix/{username}_topic(username 取自本地 git 用户名并小写);PR 标题基于自默认分支以来的全部变更;PR 描述为纯文本、使用用户对话语言。
  • 创建分支、提交、推送并创建 PR,最后向用户输出 PR URL。

使用方式 技能按步骤执行。第一步为预检:运行 git branch --show-current 获取当前分支名,若为空(分离头指针)则提示用户先切换到分支并停止;运行 gh pr list --head {branch} --state open --json number,url 查询打开的 PR;确定远端默认分支并记为 {default_branch}。随后根据当前分支、是否存在打开的 PR 选择模式:当前分支为默认分支时新建;其他分支且已有打开的 PR 时追加;其他分支且无打开的 PR 时新建。 第二步为暂存与生成提交信息:运行 git status --porcelain 检查变更,无输出则跳到第三步;若同时存在已暂存和未暂存变更,则询问用户是仅提交已暂存文件(部分)还是暂存全部(全部);否则默认全部。若选全部则运行 git add -A,若选部分则跳过。随后读取已暂存差异(git diff --cached)并生成提交信息。 第三步为提交与推送。追加模式下,若有已暂存内容则先提交,然后推送并输出已有 PR URL;若既无可提交也无可推送内容,则告知用户并停止。新建模式下,先生成 PR 元数据,再创建分支、提交、推送并创建 PR,命令包括 git checkout -b {branch_name}、git push -u origin {branch_name} 以及 gh pr create --title "{title}" --body ...,最后输出 PR URL。

适用场景 适用于需要遵循 PR 工作流提交代码的团队或个人,尤其是希望自动判断新建还是追加 PR、并自动生成提交信息与 PR 描述的场景。

限制 技能明确规定:绝不强制推送;绝不直接推送到 main/master,始终走 PR 流程;所有面向用户的文本必须使用用户在对话中使用的语言,不得默认英文;呈现选项时应使用可交互对话框而非纯文本。关于收费、价格、平台支持范围等信息,资料中暂未提供。