用途:在当前分支工作完成后,提交改动、推送并创建拉取请求(PR)。
主要能力与用法:若仍在默认分支,先创建或切换到任务分支。用 Conventional Commit 风格的主题提交预期改动,只暂存预期文件。写 PR 正文前,先查找仓库的 PR 模板,检查 .github/pull_request_template.md、.github/PULL_REQUEST_TEMPLATE.md、pull_request_template.md、docs/pull_request_template.md 及 .txt 变体;若 .github/、仓库根或 docs/ 下存在 PULL_REQUEST_TEMPLATE/ 目录,则按仓库或用户指定的模板,否则使用默认模板(若存在)。推送并打开 PR,默认标记为可审查,仅在要求或已知未完成时用草稿。标题类似提交主题,在 squash-merge 仓库中会成为默认分支上的提交。有模板时按模板写正文,保留标题并依据 diff 和工作填写相关部分:改了什么及原因、工单链接(若有)、运行的检查及结果、已修复的审查问题、未检查的内容;无模板时写简洁正文包含同样细节。最后报告 PR URL。
规则与限制:每个分支一个 PR,若已有打开的 PR 则推送并更新它。保留人工对正文的编辑,只更新新提交带来的变化。遵循仓库 PR 模板(若存在)。绝不声称未运行的检查。若推送或创建 PR 失败,将工作保留在本地并报告确切失败。