SuperAPI AI 工具集

create-pr

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:当用户要求从本地检出仓库准备、发布或打开 GitHub Pull Request 时使用。

主要能力:先用本地 Git 确认仓库身份、分支、差异、暂存、提交与推送;优先用 GitHub 连接器获取仓库与 PR 上下文并创建 PR;连接器覆盖不足时用 gh 做认证检查、Actions 日志、当前分支 PR 发现、fork 头语法或创建 PR。

使用方式:读取仓库说明,解析仓库根、当前分支、远程、上游与远程默认分支;检查 git status --short --branch、合并基点、git log --oneline <base>..HEAD、git diff --stat <base>...HEAD 与完整差异。仅在混合无关改动时确认范围,保留范围外用户改动。停留在已有功能分支;若在默认分支则按仓库或主机约定新建描述性分支。必要时抓取目标远程;仅在要求或仓库策略需要时 rebase 或 merge。运行相关聚焦检查与仓库门禁,区分回归与基线/环境失败。创建最少可审查提交,遵循提交信息约定,每次提交前检查暂存差异。标题按实际结果与仓库约定撰写,正文从模板开始,说明改动、原因、真实验证结果、影响、风险、迁移、发布与关联 issue,删除空的可选章节,不声称未运行的检查或未来工作已完成。仅在用户要求或确认发布时推送,新远程分支用 git push -u <remote> <branch>;未经单独明确批准不得强制推送,批准后用 --force-with-lease。默认创建 ready-for-review PR,仅用户明确要求时用 draft。连接器字段包括 repository_full_name、base、head、title、body、draft。gh 回退示例:gh pr create --repo <owner/repo> --base <base> --head branch-or-user:branch --title "<title>" --body-file <prepared-body.md>,草稿加 --draft。gh pr create --head 不支持组织作为 head owner,跨仓库且 base 与 fork 同属一个组织时用连接器或 REST:gh api --method POST repos/<base-owner>/<base-repo>/pulls -f title="<title>" -F body=@<prepared-body.md> -f base="<base>" -f head="<organization>:<branch>" -f head_repo="<fork-repo>" -F draft=false。优先显式标题与正文,不用未审查的 --fill;--body-file 只发布 Markdown 文本,不上传本地路径文件。

证据:盘点已有截图、录屏、预览、日志等,仍代表最终改动且通过安全检查时使用;先创建含文本证据章节的 PR,再通过 GitHub 附件 UI 上传本地截图或录屏,替换占位符为 GitHub 生成 URL,添加可访问标签与上下文,保存后重新打开 PR 验证每个图像或录屏对目标受众可见。

验证:确认 URL、仓库、base/head、草稿状态、标题正文、包含提交、改动文件范围、证据链接与当前检查。可用 gh pr view --json url,number,title,baseRefName,headRefName,isDraft,commits,mergeable,statusCheckRollup 与 gh pr checks <number>。未经用户授权不手动重跑检查。

限制与安全:不静默暂存无关工作,不从错误仓库或分支创建 PR;不代替用户运行交互式认证,认证缺失时报告确切前置条件;不在 PR 证据中暴露密钥、个人数据、私有 URL、客户数据或无关浏览器内容;除非仓库明确要求版本化证据,不单纯为附件而提交截图或录屏。交付时报告分支、提交、推送目标、PR URL 与状态、验证、已附证据、待手动证据步骤、检查状态与未解决风险;省略视觉证据时说明简要原因。