Azure Pr

Azure DevOps PR Workflow

Prerequisites

Verify az CLI is available before proceeding. Run:

az --version

If the command fails, inform the user how to install it:

• macOS: brew install azure-cli
• Windows: winget install --exact --id Microsoft.AzureCLI
• Linux: curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Windows shell requirement: All commands in this skill use bash syntax (sed, grep, etc.). On Windows, run in Git Bash or WSL — PowerShell and cmd are not supported.

Then ensure the Azure DevOps extension is installed:

az extension add --name azure-devops

Detect Repository Info

Extract organization, project, and repository from the git remote:

# Remote URL format: https://{org}@dev.azure.com/{org}/{project}/_git/{repo}
REMOTE_URL=$(git remote get-url origin)
ORG=$(echo "$REMOTE_URL" | sed -n 's|.*dev.azure.com/\([^/]*\)/.*|\1|p')
PROJECT=$(echo "$REMOTE_URL" | sed -n 's|.*dev.azure.com/[^/]*/\([^/]*\)/.*|\1|p')
REPO=$(echo "$REMOTE_URL" | sed -n 's|.*/_git/\(.*\)|\1|p')

Use these values for --organization, --project, and --repository flags below.

Branch Naming

• feature/ — new features
• fix/ — bug fixes
• refactor/ — refactoring

All development happens through feature branches. Never commit directly to main.

Full Workflow

1. Create branch (if not already on one)

git checkout -b /

2. Stage and commit

git add 
git commit -m "$(cat (): 

EOF
)"

3. Push branch

git push -u origin 

4. Create PR

az repos pr create \
  --title "(): " \
  --description "$(cat 

## Test plan
- [ ] 
EOF
)" \
  --source-branch  \
  --target-branch main \
  --organization "https://dev.azure.com/$ORG" \
  --project "$PROJECT" \
  --repository "$REPO"

The command returns JSON. Extract pullRequestId to form the PR URL: https://dev.azure.com/$ORG/$PROJECT/_git/$REPO/pullrequest/

5. Link work items (if provided)

If the user provides work item IDs — either explicitly with --work-items or just as bare numbers (e.g., 12345, #12345) — add the --work-items flag to the az repos pr create command:

az repos pr create \
  ... \
  --work-items  

Detection rules:

• --work-items 12345 67890 — explicit flag, use as-is
• 12345 or #12345 — bare number in user input, treat as work item ID
• Strip any # prefix before passing to --work-items
• Multiple IDs are space-separated: --work-items 12345 67890

Notes

• Keep PR title under 70 characters. Use the description for details.
• Use HEREDOC (cat <<'EOF') for commit messages and PR descriptions to handle special characters.
• Default target branch is main. Override with --target-branch if different.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ahmadharis
• Source: ahmadharis/agentskills
• License: MIT

Install and usage instructions live in the source repository linked above.