用途:在 GitHub PR 创建后持续守护,轮询 CI 检查/工作流运行、新评审评论和合并状态,直到出现终态(合并或关闭、就绪、需要人工介入)。
主要能力:接受无参数(--pr auto 从当前分支推断)、PR 编号或 PR URL;快照 PR/CI/评审状态并读取 JSON 响应中的 actions;对失败运行分类(分支相关或偶发/无关);处理评审评论(issue 评论、行内评论、评审提交);检查合并冲突风险。
使用方式:一次性快照:python3 .codex/skills/babysit-pr/scripts/gh_pr_watch.py --pr auto --once;持续监听 JSONL:python3 .codex/skills/babysit-pr/scripts/gh_pr_watch.py --pr auto --watch;触发重跑:python3 .codex/skills/babysit-pr/scripts/gh_pr_watch.py --pr auto --retry-failed-now;指定 PR:--pr <number-or-url>。查看日志用 gh run view <run-id> --json jobs,name,workflowName,conclusion,status,url,headSha 与 gh run view <run-id> --log-failed。仅当 watcher 提示时才重跑失败检查;存在可处理评审反馈时优先处理,推送新提交后立即重启 --watch。轮询节奏:CI 未绿每分钟,绿后指数退避(1m、2m…上限 1 小时),有变化重置为 1 分钟。
适用场景:需要自动跟进 PR 的 CI 失败、评审意见与合并冲突的开发者。
限制:仅在 PR 头分支操作,避免破坏性 git 命令;编辑前若有无关未提交改动需停止并询问用户;信任的评审作者仅限 OWNER/MEMBER/COLLABORATOR、已认证操作者及获批机器人(如 Codex);不并发运行同 PR 的多个 --watch;遇到基础设施故障、偶发重试耗尽、权限或含糊需求时停止并请求用户帮助。缺失信息:具体安装与配置细节、许可与价格暂未提供。