SuperAPI AI 工具集

pr

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:为当前 Git 分支创建或更新一个简洁、结构化的拉取请求(PR)。触发方式包括输入“/pr”“create a PR”“open a pull request”。不使用子代理,按步骤顺序执行。

主要能力:

  1. 收集上下文:运行携带脚本 bash <skill-base-dir>/scripts/gather-pr-context.sh,输出分支名、JIRA 键候选、未提交变更、检测到的基分支、堆叠 PR 设置与父 PR 候选、推送状态、提交与相对 merge-base 的差异(超过 400 行截断,可用 MAX_DIFF_LINES 提高)、仓库中的 PR 模板,以及该分支是否已有 PR。若当前分支就是基分支、基分支前无提交、或 gh 不可用/未认证,则提前停止并给出一行说明。
  2. 堆叠 PR:仅当 gh 可用且已认证、启用堆叠(skills.pr.stacked=true 或 $ARGUMENTS 含 stacked,含 no-stacked 则禁用)、且存在父级时考虑。使用官方 gh stack 扩展(github/gh-stack)。识别父级后重新推导提交与差异:git log --oneline <parent-ref>..HEAD、git diff --stat <parent-ref>..HEAD、git diff <parent-ref>..HEAD。
  3. 起草标题:祈使语气,无句号,含 JIRA 前缀不超过 70 字符,格式为 BRO-XX <简短祈使摘要>。
  4. 起草正文:简短结构化,优先要点,无营销内容。有 PR 模板则使用,保留所有章节与检查项,仅勾选可验证项,不适用章节写“–”。
  5. 创建前确认:通过 AskUserQuestion 询问,预览中放入完整标题与正文,说明基分支、提交数、是否推送、远程分支名,并提供 Create as draft 与 Cancel。未获批准不得推送或创建。
  6. 创建或更新:批准后按需推送(git push -u origin <branch>),用 gh pr create --base <> --title "" --body ... 创建;堆叠 PR 创建成功后运行 gh stack link <parent PR number> <new PR number> 加入 GitHub Stack。已有 PR 则展示当前状态并确认后更新。

适用场景:日常分支提交前快速生成规范 PR,特别是需要堆叠 PR 或遵循仓库 PR 模板的团队。

限制:不静默安装 gh stack 扩展;gh pr create 失败时原样报错并停止,不自行重试;gh stack link 失败时仅报告 URL 与错误。JIRA 键仅作候选,非事实。具体收费、平台支持等资料暂未提供。