用途:Ship 用于把当前分支从“进行中”推进到“可合并”。它面向完整的 PR 看护循环,而不是一次性的代码评审或单次推送。
主要能力:确认当前处于真实功能分支;查找或创建 PR;监控 CI 与评审活动;逐条处理自动化评审评论;推送修复并反复检查;仅在 PR 可合并或被人工决策阻塞时停止。
使用方式:基于当前本地分支工作,使用 gh 完成 GitHub 操作,如 gh pr view、gh pr create、gh pr checks、gh pr review 和 gh api;评审线程信息不足时使用 gh api graphql。每次推送后都要重新监控检查。对每条机器人评论先判断是否有效:有效则实现修复、推送、回复改动并解决线程;无效则不修改代码、回复理由并解决线程。不要自动解决人类评审者的评论,除非用户明确要求。只有用户明确要求时才合并;若要求 squash merge 则使用 squash merge。
适用场景:用户要求 ship 分支、按需创建 PR、监控 CI 直到稳定、处理 AI 评审机器人或自动化评论、让 PR 保持可合并、全部通过后 squash merge。
限制:若 git branch --show-current 为空或处于 detached 状态,或位于 main/默认分支,应停止并告知用户。遇到 GitHub 认证缺失、PR 创建需要产品输入、非平凡合并冲突、评审评论需要产品决策、必需检查挂起或反复不稳定、仓库设置阻止线程解决或合并时,应停止并询问用户。不要在必需检查仍失败或待定时宣布成功;若仓库未配置检查,需确认后聚焦评审状态与可合并性。合并后若本地仍在功能分支,切回 main 或默认基础分支。