用途:针对一个已存在的 PR,驱动其收敛到可合并的终态,并处理跨 PR 合并冲突。它不负责问题分诊、决定修哪些问题或开新 PR,这些属于父编排器职责。
主要能力:按 Phase 0.P 先出计划(硬门禁),再分类 copilot-pull-request-reviewer[bot] 内联评审,组合 autopilot-pr-review-worker 做咨询性评审,合并后续项并按 fold-vs-defer 规则处理,运行 owner_touch_gate.py 做规范所有者与功能证据门禁,编辑代码、跑 lint、推送、恢复 CI 至绿色,最后返回 schema 校验的 completion_return(ready-to-merge、advisory-with-deferred、superseded 或 blocked)。
使用方式:由父调度器为批次中每个 PR 生成一个子代理,传入 PR_NUMBER、ISSUE_NUMBER、AUTHOR、HEAD_REPO、HEAD_BRANCH、MAINTAINER_CAN_MODIFY、REPO_ROOT、ORIGIN 等输入。组合前须探测依赖:
test -f ../autopilot-pr-merge-worker/assets/worker-prompt.md
&& test -f ../autopilot-pr-merge-worker/assets/completion-schema.json
&& test -f ../autopilot-pr-merge-worker/scripts/owner_touch_gate.py
&& echo "autopilot-pr-merge-worker present"
|| echo "MISSING autopilot-pr-merge-worker - stop and ask the operator"
写入默认开启,可通过激活卡关闭;关闭时只返回模板,不评论、不加标签、不推送、不请求评审者。所有副作用经 gh、git、uv run ruff 等确定性 CLI 执行。
限制:外层收敛迭代上限 4,Copilot 分类轮次上限 2,CI 恢复迭代上限 3;达到上限仍有可折叠项时返回 advisory-with-deferred。终态 ready-to-merge 需真实 CI 绿色证据、lint 静默及通过规范所有者门禁。缺失证据留在循环内或返回 blocked,不会延后。