用途:当目标 issue 有 2 个以上未关闭依赖、且因没有单一 base 分支导致调度器无法自动堆叠时,使用 oh-join 做扇入处理。调用方式为 /oh-join <issue-number>,参数为目标 GitHub issue 编号(如 1178 或 #1178)。
主要能力:读取目标 issue 的“Depends on:”依赖;用 gh pr list 查找各依赖 issue 关联的开放 PR(依据分支模式 issue/<N> 或 issue-<N>,或 PR 正文中的 Closes/Fixes/Resolves #N);确定共同 base 分支(全部相同则直接采用,不同则尝试寻找共同上游,失败则 blocked);对每个依赖 PR 做就绪检查,要求非草稿、可合并、CI 通过、审查结论不是 CHANGES_REQUESTED;按依赖 issue 编号升序,用 gh pr merge <pr-number> --squash 合并,并显式 gh issue close 关闭依赖 issue(因合入非默认分支不会自动关闭);随后重写目标 issue 的“Depends on:”为单一可读的 #<B> 基准依赖(base 必须是 issue/<B> 或 issue-<B>),追加 <!-- oh-join --> 机器段,并用 gh issue edit --body-file 写回。最后必须调用 signal_completion,工具不可用时以一行 COMPLETION 结尾。
适用场景:多依赖扇入、需要统一合并到同一 base 分支并更新依赖关系的开源协作流程。
限制:依赖少于 2 个、存在依赖无开放 PR、base 分支冲突无法安全统一、base 非 issue 分支(如 main/master)、任一就绪检查失败时均停止并返回 blocked;合并失败立即停止并报 error。安全规则要求不合并与目标依赖无关的 PR、CI 红或待定不合并、首次合并失败即停止、不删除依赖上下文。