SuperAPI AI 工具集

create-pr

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:通过 gh CLI 创建或更新 GitHub 拉取请求(PR)。可根据分支名自动提取工单号,并依据提交记录生成 PR 标题与正文;自动识别已存在的 PR 并切换为更新模式。

主要能力:自动提取分支名中的工单号并按类型前缀生成标题;从提交生成 Summary、Ticket、Test plan 正文;检测分支是否已推送及是否已有 PR;更新模式会重新生成内容并与当前 PR 比对后再决定更新;提供内容净化(sanitize)步骤,扫描并移除 AI 署名类禁止模式;支持 dry-run 预览与需确认的 --execute 实际执行。

使用方式:调用形式为 /create-pr [--head <branch>] [--base <branch>] [--title <title>] [--stack <branch...>] [--update] [--execute] [--dry-run]。--head 指定源分支(默认当前分支),--base 指定目标分支(默认 {TARGET_BRANCH} 或 main),--title 覆盖自动标题(与 --stack 互斥),--stack 为堆叠 PR 链模式(与 --head 互斥),--update 强制更新,--dry-run 为默认仅预览,--execute 需用户确认后真正执行。无参数时使用当前分支与默认目标分支,dry-run 模式,并自动检测已有 PR 转为更新模式。堆叠模式需读取 references/stack-mode.md,按 Phase A、B、D0 后接原生委托或 Phase C 执行。净化实现脚本为 skills/create-pr/scripts/sanitize-pr-content.sh,并读取 scripts/commit-msg-guard.sh 的禁止模式。

适用场景:在 Git 仓库中快速生成规范 PR 描述、更新已有 PR 标题与正文、生成堆叠 PR 链。

限制:创建或更新 PR 需 --execute 且用户确认;头分支未推送、--update 但无 PR、创建模式下两分支无提交时均会警告并停止;dry-run 仍会执行 git fetch --prune origin,但不执行变更性 gh 调用;净化仅覆盖其自身流程不发布未扫描内容,不能防御同一用户的并发写入;被移除的匹配行内容不会回显。