SuperAPI AI 工具集

github-pr

编程与开发

查看项目

更新于 10-15 21:53

技能介绍

用途:协助使用者建立或修改 GitHub Pull Request,自动分析当前分支的 commits 并生成繁体中文(zh-TW)PR 标题与描述。适用于「建立 PR」「create pull request」「帮我开 PR」「修改 PR 内容」等请求。

主要能力:建立 PR(从当前分支到目标分支,默认 main);修改 PR(更新现有 PR 的标题或描述);分析 commits(汇总分支变更生成 PR 内容)。

使用方式:先检查当前分支是否已有 PR,执行 gh pr view --json number,title,state,url。若 state 为 OPEN 则进入修改流程,用 gh pr edit 更新;若不存在则进入建立流程。建立前确认分支已推送远端:git rev-parse --abbrev-ref HEAD 与 git ls-remote --heads origin <分支>,未推送则 git push -u origin <分支>。取得 commits:git --no-pager log --oneline <目标分支>..<当前分支>,并用 git --no-pager show <commit-hash> --stat 查看详情。生成标题与描述后,推荐用 --body-file 避免转义问题:gh pr create --base <目标分支> --head <当前分支> --title "<标题>" --body-file pr-body.md。常用选项包括 --draft、--reviewer、--assignee、--label。修改 PR 可用 gh pr edit <编号或URL> --title/--body/--add-reviewer/--add-label。

适用场景:需要快速生成规范 PR 内容、批量整理分支变更、更新已有 PR 信息。

限制:仅处理已提交的变更,忽略未 staged 的变更;需要已安装并登录 GitHub CLI(gh);目标分支未指定时默认 main;PR 标题与描述使用繁体中文。参考资料包括 references/pr-template.md 与 references/gh-pr-commands.md。