# watch-uat-github-pr

> Watch a GitHub UAT PR for maintainer feedback or approval by polling comments until approved/passed.

- Author: copilot-swe-agent[bot]
- Repository: oocx/tfplan2md
- Version: 20260125000903
- Stars: 51
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/oocx/tfplan2md
- Web: https://mule.run/skillshub/@@oocx/tfplan2md~watch-uat-github-pr:20260125000903

---

---
name: watch-uat-github-pr
description: Watch a GitHub UAT PR for maintainer feedback or approval by polling comments until approved/passed.
compatibility: Preferred: GitHub chat tools configured for the repo. Fallback: repo wrapper scripts (requires GitHub CLI (gh) authenticated), plus network access.
---

# 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
```bash
scripts/uat-watch-github.sh <pr-number>
```

### 2. Optional: Tune polling interval / timeout
```bash
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)