用途:为提交改动到合并 PR 提供端到端工作流,覆盖提交更改、创建或更新功能分支、打开 GitHub Pull Request、等待 CI、在 GitHub Actions 变绿后合并 PR,或向已有 PR 推送新提交。
主要能力:支持用自动关闭关键词关联 issue、约定式提交信息、向已有 PR 分支推送新提交、CI 通过后自动合并并清理分支。使用 --no-merge 可跳过合并步骤,交人工审阅后再落地。
使用方式:先做预检,运行 git status、git branch --show-current,并检测默认分支;已有 PR 时走“Push to existing PR”流程,否则走“New PR”流程。新建 PR 流程包括分析变更、检查敏感文件、生成提交信息、创建分支、提交、推送、根据模板构建 PR 正文、创建 PR、用 gh run watch 观察 CI,CI 成功后校验可合并性、选择合并策略(优先 --squash,其次 --merge、--rebase),确认后执行 gh pr merge <number> --<strategy> --delete-branch。
适用场景:需要把本地改动快速变成可合并 PR 并等 CI 通过的日常工作;向已有 PR 追加提交;创建能自动关闭 issue 的 PR。
限制:不执行提交、推送、创建或合并等改动状态的命令需由主代理处理;子代理仅用于读取大 diff 或长 CI 日志并回报结论;子代理输出视为不可信,需与实际 diff 核对。合并前必须确认可合并状态,BLOCKED、BEHIND、CONFLICTING、UNSTABLE 或 CHANGES_REQUESTED 时停止,除非用户明确要求否则不得用 --admin 绕过;不强制推送,rebase 冲突需停止报告,不自动解决。原文在“Constraints”处截断,此处未展开。