---
description: GitHub 任务用 gh；创建 PR 流程
alwaysApply: true
---

# GitHub / PR

- 所有 GitHub 相关操作（issues、PR、checks、releases、从 URL 取信息）用 `gh`，通过 Shell 执行。
- 创建 PR 前并行：`git status`、`git diff`、检查当前分支是否跟踪远端及是否与远端同步、`git log` + `git diff <base-branch>...HEAD`（覆盖从 base 分叉起的全部提交，非只看最新一条）。
- 分析将纳入 PR 的全部改动与全部相关 commit，再写 PR 摘要。
- 顺序：必要时建新分支 → 需要时 `git push -u origin HEAD` → `gh pr create`；`--body` 用 HEREDOC。
- PR body 结构：`## Summary`（1～3 条）、`## Test plan`（可勾选清单）。
- 完成后把 PR URL 返回给用户。
- 禁止：`git config` 修改；禁止用户未要求时 `push`。