SuperAPI AI 工具集

create-pr

编程与开发

查看项目

更新于 11-08 11:57

技能介绍

用途

create-pr 是面向 yaklang/yakit 仓库的一站式 PR 流程技能,目标是把一次提 PR 的完整链路——提交工作区改动、代码评审、推送远端、创建或更新 PR——串联起来。当用户要求提 PR、提交 PR、创建 PR、发 PR、raise/submit/open PR、create PR、更新已有 PR 时使用。调用即视为授权 push 与创建 PR,不再逐步确认;但 commit 仍走 commit-msg 弹窗。技能明确不整理历史 commit、不改写远端、不 force push、不合并 PR。

主要能力

  • 前置检查:确认当前分支(非空、非 detached HEAD、非 master)、origin 必须为 yaklang/yakit(不支持 fork)、gh 安装与登录状态、code-review skill 是否存在、fetch origin master、检查 git status 与未推送 commit。
  • 工作区改动处理:提供“提交为一个 commit”或“stash 暂存”两种选择;提交时优先调用 commit-msg,找不到则按规范自行生成提交信息。
  • 强制代码评审:在推送前调用 code-review,范围为本分支 vs origin/master,提取 P0+P1 问题与合并结论;评审只记录问题,不顺手修复。
  • 推送校验:推送前核对 HEAD SHA 与评审时一致,使用显式 origin 推送,推送后校验远端 OID 与本地 HEAD 一致;push 被拒则停止,不 pull/rebase/force push。
  • PR 标题与描述生成:从全部 commit 完整 message 归纳单行 type: subject 标题;按 .github/PULL_REQUEST_TEMPLATE.md 填写描述;处理改动类型勾选、fix 归因、关联 Issue/PR、背景与方案、影响范围、合并方式、代码评审结论与建议合并前修复的问题。
  • 合并方式判定:用户指定优先;更新已有 OPEN PR 时保留旧勾选;自动规则按作者数与 commit 数选择 merge、rebase 或 squash。
  • 创建或更新 PR:gh 可用时按查重快照选择新建或 gh pr edit 更新;更新时必须带 --title;动态文本用临时文件与 --body-file,避免 shell 内插。
  • gh 降级:未安装或未登录时提供“安装并登录 gh”或“手动创建 PR”二选一;手动模式不执行 gh、不写文件,在对话中展示标题、描述与创建入口链接。

使用方式

技能通过当前环境的加载机制调用;没有专用 Skill 工具时,直接读取真实 SKILL.md 及其所需 references 并遵循。文中 AskUserQuestion 指当前环境可用的交互工具,无适用工具则在对话中询问,并等待用户真实答复。输入(合并方式、关联 Issue/PR)从用户原文识别,不追问、不猜测、不搜索。用户只要求生成描述不创建时,可按实际要求裁剪步骤。

适用场景

适用于 yaklang/yakit 仓库中需要提交改动并创建或更新 PR 的日常开发流程,尤其是希望一次完成 commit、评审、push、PR 创建且接受调用即授权 push 的场景。

限制

不支持 fork,origin 必须为 yaklang/yakit;origin 指向个人 fork 时第 1 步停止并提示自行推送后用网页创建 PR。PR base 固定 master。code-review skill 不存在则立即停止,不自行评审。gh 查询失败不能当作“无 PR”。更新已有 OPEN PR 时 gh pr edit 整段替换 body,需按规则保留旧勾选、关联与累积问题;已有 CLOSED/MERGED PR 不更新、不 reopen。手动模式无法自动查重,需用户自行处理创建结果。