用途:在用户要求创建 PR 或提交变更时,按项目约定安全可靠地创建 GitHub Pull Request。
主要能力:创建前执行预检清单,包括用 git status 检查未提交变更、用 git diff main...HEAD 审查自身差异、确认当前分支正确、用 git push -u origin <branch-name> 推送分支;随后提供将执行的 gh pr create 命令并等待用户确认。
约定:分支命名使用 type/issue-number-slug 或 type/slug,类型限 feat、fix、docs、refactor、chore,例如 feat/123-add-login、fix/memory-leak。PR 标题遵循 Conventional Commits 格式 <type>[optional scope][optional !]: <description>,例如 feat(auth): add OAuth2 login。若仓库存在 .github/pull_request_template.md 则按其填写正文;否则说明 PR 做了什么、为何修改及测试步骤。
限制与注意:避免模糊标题;不要跳过或删除 PR 模板;创建前必须审查 diff,防止混入调试语句、密钥或无关文件;不要默认目标分支为 main 或 master,需先核实基础分支。
示例命令:gh pr create --title "feat(auth): add login page" --body "..."。