用途:将源分支(BRANCH,必填)落合并到目标分支(TARGET,默认 main)上,通过一次性浅克隆完成远程集成,并仅在主工作树(PRIMARY)已位于目标分支时更新它。适合 /ship、/reflect 等需要安全本地合并路径、不想直接改动活跃工作树的场景。
主要能力:分两阶段处理。阶段一远程集成:解析仓库根、源/目标分支、远程名与主工作树;校验分支引用与远程引用;在一次性浅克隆中检出目标分支并合并源分支,默认普通合并并接受快进;推送更新后的目标分支。阶段二本地传播:仅当 PRIMARY 已在目标分支时执行,检查本地目标状态(是否有已跟踪改动、领先/落后计数、仅本地提交等),干净且落后时自动快进,存在仅本地提交时要求用户选择 rebase 或 merge。
必要用法:使用本地 git 进行合并与发布;优先一次性浅克隆作为集成工作区;状态变更命令使用绝对路径与 git -C <abs-path>;操作前校验 refs。若源分支未发布但可干净推送,先推送再继续。
限制与规则:绝不 force-push;不静默解决冲突,冲突即停止并交还用户;不使用硬重置(除非明确指示);对分歧的本地目标分支不静默选择 merge 还是 rebase;源分支若存在未反映到已发布分支的已跟踪本地改动则停止;浅克隆历史不足时加深或报告限制;推送被拒最多重试 3 次,重试冲突或变得模糊时立即停止;一次性克隆清理失败不阻塞。需要时用“已跟踪状态暂存”配方(仅暂存已跟踪改动、创建临时 WIP 提交、记录引用、更新后软重置恢复),不静默包含未跟踪文件。