用途:从已推送的分支创建 GitHub Pull Request,生成结构化描述、标签、审查者与 issue 引用。适用于“create PR”“open pull request”“submit for review”等场景。若分支尚未推送,需先用 git-push;若有未提交改动,需先用 git-commit;若只需编写或修正 conventional 标题,用 github-pr-title;若需提交+推送+PR 一体化,用 git-commit-push-pr。
主要能力:按标准模板生成 PR 描述,包含 Summary、Motivation、Changes、Pre-merge Checklist、Follow-up Issues、Related Issues 等章节;支持 Fixes #N / Closes #N / Resolves #N 自动关闭语法,Related: #N 仅关联不关闭;支持草稿、标签、审查者、基分支、指派人等选项;支持堆叠 PR 的依赖检测与重定向;支持为合并后跟进事项创建独立 issue。
使用方式:先运行数据收集脚本评估 PR 就绪状态,命令为 bash "${CLAUDE_SKILL_DIR}/scripts/git-pr.sh" --home-dir "$HOME" --project-dir "$(pwd)" --base origin/main。分析提交时始终以 origin/main 为基准:git fetch origin main、git log origin/main..HEAD --format='%H %s'。创建 PR 时建议将正文写入临时文件再通过 --body-file 传入:gh pr create --title "feat(scope): add feature" --body-file /tmp/pr-body.md。创建后需校验关闭关键字,可运行 gh pr view --json body --jq .body > /tmp/pr-body-check.md 后再次调用脚本检查。
限制与注意:不要用 markdown 表格追踪关联 issue,GitHub 自动关闭仅识别正文或提交中的 Fixes/Closes/Resolves 关键字;Pre-merge Checklist 只放合并前动作,合并后事项应创建独立 issue;堆叠 PR 中父 PR 合并时若删除头分支会关闭所有依赖 PR,需先重定向依赖或省略 --delete-branch;squash 合并后依赖 PR 需用 git rebase --onto 重放自身提交;基于特性分支的依赖 PR 在重定向前不会触发仅针对 main 的 CI。具体脚本行为与平台支持以实际环境为准。