watch-uat-azdo-pr - SKILL.md Agent Skill

name: watch-uat-azdo-pr description: Watch an Azure DevOps UAT PR for maintainer feedback or approval by polling threads and reviewer votes until approved/passed. compatibility: Requires Azure CLI (az) with azure-devops extension, authentication, jq, and network access.

Watch UAT PR (Azure DevOps)

Purpose

UAT polling is historically brittle. This skill standardizes the watch loop so the agent can reliably wait for Maintainer feedback/approval using a single stable command.

This skill uses the repo wrapper script scripts/uat-watch-azdo.sh, which repeatedly calls scripts/uat-azdo.sh poll until:

PR status becomes completed, or
an approval vote is detected, or
approval keywords are detected in non-agent comments, or
a timeout is reached.

Hard Rules

Must

Use scripts/uat-watch-azdo.sh (single stable command).
Prefer reviewer votes / PR completion as the strongest approval signal.

Must Not

Spam threads or post follow-ups while waiting.
Run many ad-hoc az/az devops invoke calls; prefer the wrapper.

Actions

1. Watch the PR

scripts/uat-watch-azdo.sh <pr-id>

2. Optional: Tune polling interval / timeout

scripts/uat-watch-azdo.sh <pr-id> --interval-seconds 60 --timeout-seconds 3600

Output

Exit code 0: approval detected / PR completed (treat as pass)
Exit code 1: timed out (treat as incomplete; ask Maintainer)