用途:在推送 Forge 分支、打开 PR 后,或需要回答“PR 是否就绪、状态如何、检查是否全绿”时使用。核心思路是读取已有的监控判定,而不是自己启动监控或替代它。
主要能力:Forge 会在受支持的会话启动后、每次成功 push 后、以及每次成功非 dry-run 的 ship 后自动唤醒仓库单例 shepherd 守护进程;重复启动在 O_EXCL 租约下是干净的空操作。因此该技能不启动守护进程,只确认其已挂载并读取输出。
使用方式:正常执行 forge ship,或在已有开放 PR 的分支上执行 forge push;用 forge shepherd events 确认守护进程接管了该 PR;用 forge shepherd <pr> --pull --json 读取该 PR 的判定;用一行报告结果,说明哪些是红灯、哪些待定、哪些需要人工处理;若没有红灯需明确说明并列出检查来源。
限制与规则:不要手动轮询,循环执行 gh pr checks 正是本技能要替代的失败模式,gh 仅可在守护进程报告后做一次源头抽查。不要合并,shepherd 不合并也不解决评审线程,合并由人工完成。与本分支无关的新问题应作为内核问题另开 PR,不要在此追加提交。不要固定等待十分钟,应等待稳定状态:所有机器人已给出终态结果、零未解决线程、无进行中的检查。若守护进程确实未挂载,应作为底层缺陷提交内核问题,而非用人工循环掩盖。已知的关闭开关为 FORGE_SHEPHERD_DISABLE 或 forge gate disable rail.auto_shepherd,但为让运行更安静而关闭监控属于错误做法。完成标准是:说明 PR 当前判定、指明读取来源,并交接给人工合并或提交后续问题。