用途:为当前分支起草或创建 PR,生成标题与正文,默认只展示草稿,用户明确要求打开/创建 PR 时才进入创建模式。
主要能力:读取 git status --short 识别任务相关文件与无关改动;解析基准分支(用户指定、已有 PR 基准,或 git symbolic-ref --short refs/remotes/origin/HEAD,否则 origin/master、origin/main);用 git diff <base>...HEAD 及 --name-status、--stat 读取改动;查找 .github/、仓库根或 docs/ 下的 PULL_REQUEST_TEMPLATE.md,保留其标题、顺序与清单措辞、复选框留空,无模板则用默认结构(Purpose、Approach,可选 Implementation details)。标题约 80 字符内,若存在 Jira key(如 BF-1523)则用 KEY: <summary> 并附链接。
使用方式:草稿模式无需 gh 或网络访问。创建模式先确认未提交任务文件是否提交,检查 gh auth status 与分支远端状态;需推送时执行 git push origin "HEAD:refs/heads/<current branch>",再用 gh pr create --base <base branch name> --head <current branch> --title "<title>" --body-file <path> 创建,正文文件放在仓库外,并返回 PR URL。
限制:不运行构建、测试、linter 或生成器,不编辑 NEWS.md,不切换分支、stash、reset、clean、强推、改 Git 配置或绕过被拒的钩子;远端已分叉时停止报告;不写入密钥或工具署名;验证信息仅在本次会话已观察或用户提供时提及。