SuperAPI AI 工具集

create-pr

通用与其它

查看项目

更新于 10-16 01:19

技能介绍

用途:把当前分支推送到远端并在 GitHub 上创建 PR,默认创建草稿(draft)PR,加 --no-draft 参数则创建待评审 PR。

主要能力:从分支名中匹配 JIRA 工单号(形如 [A-Z][A-Z0-9]+-[0-9]+,不区分大小写,任意位置均可)。若能通过 Atlassian CLI 获取工单,则用其摘要与描述生成 PR 标题和正文,并按工单类型选前缀(Bug 用 fix:,其余用 feat:)。若无工单或获取失败,则推送分支后至少提供三个标题选项供选择。PR 描述中的 Fixes 段只列出本 PR 实际修复的条目(JIRA 工单、GitHub issue 等),不含仅相关的内容;存在歧义时会询问开发者。

使用方式:命令为 /create-pr 或 /create-pr --no-draft。执行前需检查 GitHub CLI(gh --version 与 gh auth status)。若分支含 JIRA ID,还需检查 Atlassian CLI(acli auth status)。基础分支优先从当前目录 .agent 文件的 baseBranch= 读取,否则询问开发者。推送:草稿用 git push -u origin <branch-name> --no-verify;待评审用 git push -u origin <branch-name>,若被 pre-push 钩子拦截可选择绕过或解决,选择 --no-verify 时强制创建草稿 PR。最后用 gh pr create 配合 --draft 与 --base <base-branch>,正文经 HEREDOC 传入。

限制:依赖 gh 已安装并登录;涉及 JIRA 时依赖 acli 已安装并认证,缺失则给出提示并停止。前置条件未满足、推送或 PR 创建失败时均显示错误并停止。基础分支的具体取值与失败处理细节以实际执行结果为准。