scaryrawr/ado-pr

Azure DevOps Pull Request Operations

Use this skill for existing Azure DevOps pull requests.

Script execution model

• Run the bundled helpers via the skill-relative paths shown below (./scripts/... resolves from this skill directory).
• The helper scripts are non-interactive. Read structured JSON from stdout and treat stderr as diagnostics.
• If you need to confirm flags or subcommands, run ./scripts/ado-pr.mts --help.

Available scripts

context

Start with the helper script so you have normalized IDs and branch metadata before composing follow-up commands:

./scripts/ado-pr.mts context --id {prId} --detect true

Use these fields directly:

• pullRequestId, title, status, isDraft
• sourceBranch, targetBranch
• repositoryId, repositoryName
• projectId, projectName
• createdBy, url

Use --org {orgUrl} instead of --detect true when auto-detection is unavailable.

list-threads

Use the thread helper instead of hand-building the az devops invoke call each time:

./scripts/ado-pr.mts list-threads --id {prId} --status active --detect true

Use count and threads from the JSON response. Omit --status when you need all threads.

thread-payload

Never hand-write review thread JSON when the helper can do it for you:

./scripts/ado-pr.mts thread-payload \
  --content "Your comment" \
  --file-path /src/path/to/file.ts \
  --line-start 42 \
  --line-end 42 \
  --out-file /tmp/thread.json

az devops invoke --area git --resource pullRequestThreads \
  --route-parameters project={project} repositoryId={repo} pullRequestId={prId} \
  --http-method POST --api-version 7.1-preview \
  --detect true --in-file /tmp/thread.json

For top-level comments, omit the file and line flags. If you pass --out-file, the script returns { outFile, payload }; otherwise it returns the payload directly.

Workflow

1. Resolve PR context with context.
2. Retrieve threads with list-threads when you need prior discussion state.
3. Build comment payloads with thread-payload before posting inline or top-level comments.

Common PR commands

Show a PR:

az repos pr show --id {prId} --detect true

List PRs:

az repos pr list --detect true --status active --output table

Checkout a PR locally:

az repos pr checkout --id {prId}

Set a vote:

az repos pr set-vote --id {prId} --vote approve --detect true

Update PR status:

az repos pr update --id {prId} --status completed --detect true

List linked work items:

az repos pr work-item list --id {prId} --detect true

Manage reviewers:

az repos pr reviewer list --id {prId} --detect true
az repos pr reviewer add --id {prId} --reviewers {email} --detect true
az repos pr reviewer remove --id {prId} --reviewers {email} --detect true

Check policy status:

az repos pr policy list --id {prId} --detect true --output table

Rules

• Use the helper script for context lookup and thread payload generation before falling back to handwritten REST payloads.
• Keep threadContext line ranges as small as possible for file-specific comments.
• When --detect true fails, rerun with an explicit --org value.