| name | pr |
| description | Use when the user invokes /pr or asks to push changes and open a pull request, after commits are ready to be pushed to a remote branch and merged into the main branch. |
pr — Push & Pull Request
Overview
将本地提交推送到远程分支，并使用 gh CLI 创建 Pull Request，目标为仓库主分支。
默认行为：所有 PR 均以 Draft 模式创建（--draft），避免误操作导致未经审查的代码被直接 merge。需要正式发起 Review 时，由用户在 GitHub 上手动将 Draft 转为 Ready for Review。
前置条件检查
- 确认本次对话中已执行过
/commit，且有新提交未推送
- 确认当前分支不是
main / master（若在主分支，停止并提示用户切换到功能分支）
- 确认
gh CLI 已登录：gh auth status
执行步骤
1. 了解当前分支状态
git branch --show-current
git log --oneline origin/HEAD..HEAD
git diff origin/HEAD...HEAD --stat
2. 确定目标分支
按以下顺序判断：
- 仓库默认分支（
gh repo view --json defaultBranchRef -q .defaultBranchRef.name）
- 若无法获取，依次尝试
main → master
- 仍不确定时，询问用户
3. 推送到远程
git push -u origin <当前分支名>
若远程已有同名分支且有分歧，不使用 --force，先告知用户手动处理冲突。
4. 起草 PR 内容
根据 git log 和 git diff 的输出，整理：
- 标题：70 字符以内，描述本次变更的核心目的
- 正文：包含变更摘要（2-4 条要点）和测试计划
5. 创建 Pull Request
始终使用 --draft 标志，避免误操作导致 PR 被直接 merge。
gh pr create \
--draft \
--base <目标分支> \
--title "<PR 标题>" \
--body "$(cat <<'EOF'
## Summary
- <要点 1>
- <要点 2>
## Test Plan
- [ ] <测试项 1>
- [ ] <测试项 2>
EOF
)"
禁止在 PR 正文中添加任何 AI 工具相关的标注，例如 🤖 Generated with Claude Code 或类似内容。
6. 输出结果
返回 PR URL，告知用户 PR 已创建成功。
常见错误
| 问题 | 处理 |
|---|
gh 未登录 | 提示用户执行 ! gh auth login |
| 当前分支无新提交 | 告知用户没有可推送的内容，建议先执行 /commit |
| 该分支已存在 PR | 使用 gh pr view 查看现有 PR，提示用户是否需要更新 |
| 推送被拒绝（non-fast-forward） | 不强制推送，提示用户检查远程分支状态 |
