pr-watch 用于在后台持续监控当前 Pull Request 的新评审评论,并自动处理这些评论。它借助 /loop 启动循环,先确认存在打开的 PR,再按解析出的间隔(--interval N,默认 5m)创建循环任务。
主要能力包括:通过 gh 命令获取代码评审评论与会话评论,识别尚未回复的顶层评论;忽略机器人账号(如 vercel、dependabot、github-actions 等);对每条顶层评论进行判断并回复——有效且值得修复就改代码并回复确认,有效但超范围就解释原因,无效或错误就说明不同意;始终回复每条评论以留下记录,但不自动解决线程,交由评审者处理。当某评论已有回复,即视为已处理。
退出条件需同时满足:所有顶层评论均有回复;本轮未推送任何修复(若推送过需再等至少两轮);最新提交的所有评审检查已完成。检查完成情况通过 gh api 查询指定 head SHA 的 check-runs,并确认评审机器人已在该提交上运行,而非使用 gh pr checks。若条件不满足则等待下一轮。
限制:需要 gh 环境并已认证;仅在存在打开的 PR 时有效;对评审机器人建议需人工判断,因其可能缺少完整项目上下文;不会自动解决评论线程。