watch-uat-github-pr

name	watch-uat-github-pr
description	Watch a GitHub UAT PR for maintainer feedback or approval by polling comments until approved/passed.

Watch UAT PR (GitHub)

Purpose

UAT comment polling is historically brittle. This skill standardizes the watch loop so the agent can reliably wait for Maintainer feedback/approval.

Preferred: use GitHub chat tools to poll PR state + comments (avoids terminal output/pager issues). Fallback: use the stable wrapper command.

Fallback path uses the repo wrapper script scripts/uat-watch-github.sh, which repeatedly calls scripts/uat-github.sh poll until:

• approval keywords are detected, or
• the PR is closed/merged, or
• a timeout is reached.

Hard Rules

Must

• Use scripts/uat-watch-github.sh (single stable command).
• Treat any detected approval (approved|passed|accept|lgtm) as UAT passed.
• Stop watching and report when the PR is closed.

Must Not

• Spam comments or post follow-ups while waiting.
• Run many ad-hoc gh commands; prefer the wrapper.

Actions

Preferred: Poll using GitHub chat tools

Repeatedly:

• Fetch PR details (state)
• Fetch PR conversation comments
• Stop and report if the PR is closed/merged
• Treat any detected approval (approved|passed|accept|lgtm) as UAT passed

Fallback: One-command wrapper

1. Watch the PR

scripts/uat-watch-github.sh <pr-number>

2. Optional: Tune polling interval / timeout

scripts/uat-watch-github.sh <pr-number> --interval-seconds 60 --timeout-seconds 3600

Output

• Exit code 0: approval detected or PR closed (treat as pass)
• Exit code 1: timed out (treat as incomplete; ask Maintainer)