Claude Skill

azure-devops

Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, and attachments. Use when user asks to: manage sprints, create/update work items, list repos, create PRs, run pipelines,

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download sanjay3290-ai-skills-skills_azure-devops-c842558.zip · 33 KB

Install

skills CLI npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/azure-devops
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
Git git clone https://github.com/sanjay3290/ai-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.

README

Azure DevOps Skill

Manage Azure DevOps projects, work items, repositories, pull requests, pipelines, wikis, test plans, and security alerts through a Python CLI. Reimplementation of the Azure DevOps MCP server as lightweight scripts.

Features

  • 13 domains, 99 tools covering the full Azure DevOps REST API
  • OAuth (device code flow) or PAT authentication stored securely in system keyring
  • Auto token refresh for OAuth - no manual re-login needed
  • No external dependencies beyond keyring - uses stdlib urllib.request
  • Consistent CLI pattern - argparse subcommands, JSON output

Domains

Domain Script Tools
Core core.py Projects, teams, identities (3)
Work Items work_items.py CRUD, queries, comments, backlogs (20)
Iterations work.py Sprints, capacity (7)
Git/PRs repos.py Repos, branches, pull requests (18)
Pipelines pipelines.py Builds, runs, artifacts (14)
Search search.py Code, wiki, work item search (3)
Wiki wiki.py Pages management (6)
Test Plans test_plans.py Plans, suites, cases, results (9)
Security security.py Advanced security alerts (2)
Variable Groups variable_groups.py Pipeline variable groups (7)
Environments environments.py Environments & approvals (8)
Policies policies.py Branch policies (8)
Attachments attachments.py Work item attachments (6)

Quick Start

1. Install dependency

pip install keyring>=24.0.0

2. Authenticate

Option A: OAuth (Recommended)

cd skills/azure-devops
python scripts/auth.py login --org MyOrganization
# Follow the URL, enter the device code to authorize
# Tokens auto-refresh - no need to re-login

Option B: PAT

Create a PAT at https://dev.azure.com/{org}/_usersSettings/tokens with scopes: Work Items (R&W), Code (R&W), Build (R&E), Wiki (R&W), Test Management (R&W), Advanced Security (R), Project and Team (R), Identity (R).

cd skills/azure-devops
python scripts/auth.py login --org MyOrganization --pat YOUR_PAT

3. Verify

python scripts/auth.py status
python scripts/core.py list-projects

Usage

All scripts follow the same pattern:

python scripts/<domain>.py <command> --project <name> [options]

Output is always JSON. Exit code 1 on errors.

See SKILL.md for complete command reference with examples.

Troubleshooting

"Not authenticated" error: Run python scripts/auth.py login

"HTTP 401": Token expired. For OAuth, run python scripts/auth.py login --org <org>. For PAT, create a new one and re-login.

"HTTP 403": PAT doesn't have the required scope for this operation.

"HTTP 404": Project, repo, or resource not found. Check the name/ID.

Keyring issues on Linux: Install secretstorage package: pip install secretstorage

Skill manifest

Azure DevOps

Full Azure DevOps integration using OAuth or PAT authentication and REST API v7.1.

First-Time Setup

Option 1: OAuth (Recommended)

Login with OAuth device code flow (shows "Visual Studio Code" prompt):

python scripts/auth.py login --org MyOrganization

Follow the URL and enter the device code to authorize. Tokens auto-refresh.

Option 2: PAT

Login with a Personal Access Token:

python scripts/auth.py login --org MyOrganization --pat YOUR_PAT

Create a PAT at https://dev.azure.com/{org}/_usersSettings/tokens with these scopes:

  • Work Items: Read & Write
  • Code: Read & Write (for repos/PRs)
  • Build: Read & Execute (for pipelines)
  • Wiki: Read & Write
  • Test Management: Read & Write
  • Advanced Security: Read (for security alerts)
  • Project and Team: Read
  • Identity: Read (for user search)

Common Commands

Check authentication status:

python scripts/auth.py status

Logout:

python scripts/auth.py logout

Core (scripts/core.py)

# List all projects
python scripts/core.py list-projects
python scripts/core.py list-projects --top 10

# List teams in a project
python scripts/core.py list-teams --project MyProject

# Search for a user identity
python scripts/core.py get-identity --search "john@example.com"

Work Items (scripts/work_items.py)

# Get a work item
python scripts/work_items.py get --project MyProject --id 123
python scripts/work_items.py get --project MyProject --id 123 --expand relations

# Create a work item
python scripts/work_items.py create --project MyProject --type "User Story" --title "New feature"
python scripts/work_items.py create --project MyProject --type Bug --title "Fix login" \
  --field System.Description "Login fails on timeout" \
  --field System.AssignedTo "user@example.com"

# Update a work item
python scripts/work_items.py update --project MyProject --id 123 \
  --field System.State "Active" \
  --field System.AssignedTo "user@example.com"

# Batch get multiple work items
python scripts/work_items.py batch-get --project MyProject --ids 1,2,3

# Add children to a parent
python scripts/work_items.py add-children --project MyProject --parent-id 100 --child-ids 101,102

# Link work items
python scripts/work_items.py link --project MyProject --source-id 100 --target-id 200
python scripts/work_items.py link --project MyProject --source-id 100 --target-id 200 \
  --link-type "System.LinkTypes.Dependency-Forward"

# Remove a link
python scripts/work_items.py unlink --project MyProject --source-id 100 --relation-index 0

# Comments
python scripts/work_items.py add-comment --project MyProject --id 123 --text "Working on this"
python scripts/work_items.py list-comments --project MyProject --id 123

# History
python scripts/work_items.py get-revisions --project MyProject --id 123

# List work item types
python scripts/work_items.py list-types --project MyProject

# My assigned items
python scripts/work_items.py my-items --project MyProject

# Items in an iteration
python scripts/work_items.py iteration-items --project MyProject --iteration-path "MyProject\\Sprint 1"

# Backlogs
python scripts/work_items.py list-backlogs --project MyProject --team "MyProject Team"

# Saved queries
python scripts/work_items.py list-queries --project MyProject
python scripts/work_items.py get-query --project MyProject --path "Shared Queries/Active Bugs"
python scripts/work_items.py run-query --project MyProject --query-id "guid-here"

# WIQL query
python scripts/work_items.py run-wiql --project MyProject \
  --query "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active'"

# Delete / recycle bin
python scripts/work_items.py delete --project MyProject --id 999
python scripts/work_items.py recycle-bin --project MyProject

Git Repos & PRs (scripts/repos.py)

# List repositories
python scripts/repos.py list --project MyProject

# Get repo details
python scripts/repos.py get --project MyProject --repo my-repo

# Branches
python scripts/repos.py list-branches --project MyProject --repo my-repo
python scripts/repos.py create-branch --project MyProject --repo my-repo --name feature/new --source main

# Commits
python scripts/repos.py search-commits --project MyProject --repo my-repo --path /src --author "john" --top 10

# Pull requests
python scripts/repos.py list-prs --project MyProject --repo my-repo
python scripts/repos.py list-prs --project MyProject --status completed --top 5

python scripts/repos.py create-pr --project MyProject --repo my-repo \
  --source feature/new --target main --title "Add new feature" --description "Details here"

python scripts/repos.py get-pr --project MyProject --repo my-repo --pr-id 42

python scripts/repos.py update-pr --project MyProject --repo my-repo --pr-id 42 --title "Updated title"

# Reviewers
python scripts/repos.py list-reviewers --project MyProject --repo my-repo --pr-id 42
python scripts/repos.py add-reviewer --project MyProject --repo my-repo --pr-id 42 \
  --reviewer-id "guid" --vote 10

# PR comments
python scripts/repos.py list-threads --project MyProject --repo my-repo --pr-id 42
python scripts/repos.py create-thread --project MyProject --repo my-repo --pr-id 42 \
  --content "Looks good!" --file-path "/src/main.py" --line 25
python scripts/repos.py add-thread-comment --project MyProject --repo my-repo --pr-id 42 \
  --thread-id 1 --content "Fixed"

# Complete or abandon PR
python scripts/repos.py complete-pr --project MyProject --repo my-repo --pr-id 42
python scripts/repos.py complete-pr --project MyProject --repo my-repo --pr-id 42 \
  --merge-strategy rebase --keep-source
python scripts/repos.py abandon-pr --project MyProject --repo my-repo --pr-id 42

# Diff
python scripts/repos.py get-diff --project MyProject --repo my-repo --base main --target feature/new

# Browse files
python scripts/repos.py list-files --project MyProject --repo my-repo --path /src --branch main

Iterations & Capacity (scripts/work.py)

# List iterations
python scripts/work.py list-iterations --project MyProject

# Create iteration
python scripts/work.py create-iteration --project MyProject --name "Sprint 5" \
  --start-date 2026-03-01 --finish-date 2026-03-14

# Get iteration details
python scripts/work.py get-iteration --project MyProject --iteration-id "guid"

# Team iterations
python scripts/work.py team-iterations --project MyProject --team "MyTeam" --timeframe current

# Assign iteration to team
python scripts/work.py assign-iteration --project MyProject --team "MyTeam" --iteration-id "guid"

# Capacities
python scripts/work.py get-capacities --project MyProject --team "MyTeam" --iteration-id "guid"
python scripts/work.py set-capacity --project MyProject --team "MyTeam" --iteration-id "guid" \
  --member-id "user-guid" --activity Development --capacity-per-day 6

Pipelines & Builds (scripts/pipelines.py)

# Create pipeline
python scripts/pipelines.py create --project MyProject --name "CI" \
  --repo-id "repo-guid" --yaml-path "/azure-pipelines.yml"

# List builds
python scripts/pipelines.py list-builds --project MyProject --top 5
python scripts/pipelines.py list-builds --project MyProject --status completed --branch main

# Get build details and logs
python scripts/pipelines.py get-build --project MyProject --build-id 100
python scripts/pipelines.py build-logs --project MyProject --build-id 100
python scripts/pipelines.py build-logs --project MyProject --build-id 100 --log-id 3
python scripts/pipelines.py build-changes --project MyProject --build-id 100

# Pipeline definitions
python scripts/pipelines.py list-definitions --project MyProject
python scripts/pipelines.py list-definitions --project MyProject --name "CI"

# Run a pipeline
python scripts/pipelines.py run --project MyProject --pipeline-id 5 --branch develop
python scripts/pipelines.py run --project MyProject --pipeline-id 5 \
  --variable ENV production --variable DEPLOY true

# Pipeline runs
python scripts/pipelines.py get-run --project MyProject --pipeline-id 5 --run-id 200
python scripts/pipelines.py list-runs --project MyProject --pipeline-id 5 --top 10

# Stage management
python scripts/pipelines.py update-stage --project MyProject --build-id 100 --stage Deploy --state retry

# Artifacts
python scripts/pipelines.py get-artifacts --project MyProject --build-id 100

# Queue and cancel builds
python scripts/pipelines.py queue-build --project MyProject --definition-id 10 --branch main
python scripts/pipelines.py cancel-build --project MyProject --build-id 100

# Latest build status
python scripts/pipelines.py build-status --project MyProject --definition-id 10

Search (scripts/search.py)

# Search code
python scripts/search.py code --project MyProject --query "TODO"
python scripts/search.py code --project MyProject --query "connectionString" --top 10

# Search wiki
python scripts/search.py wiki --project MyProject --query "deployment guide"

# Search work items
python scripts/search.py work-items --project MyProject --query "login bug"

Wiki (scripts/wiki.py)

# List wikis
python scripts/wiki.py list --project MyProject

# Get wiki details
python scripts/wiki.py get --project MyProject --wiki-id MyProject.wiki

# List pages
python scripts/wiki.py list-pages --project MyProject --wiki-id MyProject.wiki
python scripts/wiki.py list-pages --project MyProject --wiki-id MyProject.wiki --path /Architecture

# Get page content
python scripts/wiki.py get-page --project MyProject --wiki-id MyProject.wiki --path /Home
python scripts/wiki.py get-page-content --project MyProject --wiki-id MyProject.wiki --path /Home

# Create or update a page
python scripts/wiki.py create-or-update-page --project MyProject --wiki-id MyProject.wiki \
  --path /NewPage --content "# New Page\n\nContent here"

Test Plans (scripts/test_plans.py)

# Test plans
python scripts/test_plans.py list-plans --project MyProject
python scripts/test_plans.py get-plan --project MyProject --plan-id 1
python scripts/test_plans.py create-plan --project MyProject --name "Release 2.0 Tests"

# Test suites
python scripts/test_plans.py list-suites --project MyProject --plan-id 1
python scripts/test_plans.py get-suite --project MyProject --plan-id 1 --suite-id 2

# Test cases
python scripts/test_plans.py list-test-cases --project MyProject --plan-id 1 --suite-id 2
python scripts/test_plans.py add-test-cases --project MyProject --plan-id 1 --suite-id 2 --ids 100,101

# Test results
python scripts/test_plans.py list-results --project MyProject --run-id 50
python scripts/test_plans.py get-result --project MyProject --run-id 50 --result-id 1

Advanced Security (scripts/security.py)

# List security alerts
python scripts/security.py list-alerts --project MyProject --repo my-repo
python scripts/security.py list-alerts --project MyProject --repo my-repo \
  --state active --severity high --type dependency

# Get alert details
python scripts/security.py get-alert --project MyProject --repo my-repo --alert-id 42

Variable Groups (scripts/variable_groups.py)

# List variable groups
python scripts/variable_groups.py list --project MyProject

# Get a variable group
python scripts/variable_groups.py get --project MyProject --id 1

# Create a variable group
python scripts/variable_groups.py create --project MyProject --name "Deploy Vars" \
  --variable ENV production --variable REGION eastus --description "Deploy config"

# Update a variable group
python scripts/variable_groups.py update --project MyProject --id 1 --name "New Name" \
  --variable ENV staging

# Add/update a single variable (supports --secret for sensitive values)
python scripts/variable_groups.py add-variable --project MyProject --id 1 \
  --key API_KEY --value "secret123" --secret

# Remove a variable
python scripts/variable_groups.py remove-variable --project MyProject --id 1 --key OLD_VAR

# Delete a variable group
python scripts/variable_groups.py delete --project MyProject --id 1

Environments & Approvals (scripts/environments.py)

# List environments
python scripts/environments.py list --project MyProject

# Create an environment
python scripts/environments.py create --project MyProject --name "Production" \
  --description "Production environment"

# Get environment details
python scripts/environments.py get --project MyProject --id 1

# List checks/approvals configured on an environment
python scripts/environments.py list-checks --project MyProject --id 1

# List pending approvals
python scripts/environments.py list-approvals --project MyProject
python scripts/environments.py list-approvals --project MyProject --state all

# Approve/reject
python scripts/environments.py approve --project MyProject --approval-id "guid" \
  --comment "Looks good"
python scripts/environments.py reject --project MyProject --approval-id "guid" \
  --comment "Needs fixes"

# Delete an environment
python scripts/environments.py delete --project MyProject --id 1

Branch Policies (scripts/policies.py)

# List all policies
python scripts/policies.py list --project MyProject
python scripts/policies.py list --project MyProject --branch main --repo my-repo-id

# Get a policy
python scripts/policies.py get --project MyProject --id 1

# List available policy types
python scripts/policies.py list-types --project MyProject

# Create minimum reviewers policy
python scripts/policies.py create-min-reviewers --project MyProject \
  --repo-id "repo-guid" --branch main --min-reviewers 2 --reset-on-push

# Create build validation policy
python scripts/policies.py create-build-policy --project MyProject \
  --repo-id "repo-guid" --branch main --build-definition-id 10

# Update a policy (enable/disable/blocking)
python scripts/policies.py update --project MyProject --id 1 --enabled false
python scripts/policies.py update --project MyProject --id 1 --blocking true

# List policy evaluations for a PR
python scripts/policies.py list-evaluations --project MyProject --pr-id 42

# Delete a policy
python scripts/policies.py delete --project MyProject --id 1

Work Item Attachments (scripts/attachments.py)

# Upload a file
python scripts/attachments.py upload --project MyProject --file ./report.pdf

# Attach an uploaded file to a work item
python scripts/attachments.py attach --project MyProject --id 123 \
  --url "https://dev.azure.com/org/project/_apis/wit/attachments/guid" \
  --comment "Test report"

# Upload and attach in one step
python scripts/attachments.py upload-and-attach --project MyProject --id 123 \
  --file ./screenshot.png --comment "Bug screenshot"

# List attachments on a work item
python scripts/attachments.py list --project MyProject --id 123

# Download an attachment
python scripts/attachments.py download --project MyProject \
  --url "https://dev.azure.com/org/project/_apis/wit/attachments/guid" \
  --output ./downloaded.pdf

# Remove an attachment by relation index
python scripts/attachments.py remove --project MyProject --id 123 --index 0

Common Work Item Fields

Field Reference Name
Title System.Title
State System.State
Assigned To System.AssignedTo
Description System.Description
Area Path System.AreaPath
Iteration Path System.IterationPath
Priority Microsoft.VSTS.Common.Priority
Story Points Microsoft.VSTS.Scheduling.StoryPoints
Tags System.Tags
Repro Steps Microsoft.VSTS.TCM.ReproSteps
Acceptance Criteria Microsoft.VSTS.Common.AcceptanceCriteria

Link Types

Link Type Reference Name
Related System.LinkTypes.Related
Parent → Child System.LinkTypes.Hierarchy-Forward
Child → Parent System.LinkTypes.Hierarchy-Reverse
Predecessor System.LinkTypes.Dependency-Forward
Successor System.LinkTypes.Dependency-Reverse

Token Management

Credentials stored securely using the system keyring:

  • macOS: Keychain
  • Windows: Windows Credential Locker
  • Linux: Secret Service API

Service name: azure-devops-skill

Files (ai-skills)
  • scripts
    • api_client.py 5.6 KB
      Loading…
    • attachments.py 6.7 KB
      Loading…
    • auth.py 14.7 KB
      Loading…
    • core.py 1.8 KB
      Loading…
    • environments.py 5 KB
      Loading…
    • pipelines.py 10 KB
      Loading…
    • policies.py 7.8 KB
      Loading…
    • repos.py 15.3 KB
      Loading…
    • search.py 2.8 KB
      Loading…
    • security.py 2.4 KB
      Loading…
    • test_plans.py 5.8 KB
      Loading…
    • variable_groups.py 5.5 KB
      Loading…
    • wiki.py 4.2 KB
      Loading…
    • work.py 5.3 KB
      Loading…
    • work_items.py 14 KB
      Loading…
  • README.md 2.9 KB
    # Azure DevOps Skill
    
    Manage Azure DevOps projects, work items, repositories, pull requests, pipelines, wikis, test plans, and security alerts through a Python CLI. Reimplementation of the [Azure DevOps MCP server](https://github.com/microsoft/azure-devops-mcp) as lightweight scripts.
    
    ## Features
    
    - **13 domains, 99 tools** covering the full Azure DevOps REST API
    - **OAuth (device code flow)** or **PAT authentication** stored securely in system keyring
    - **Auto token refresh** for OAuth - no manual re-login needed
    - **No external dependencies** beyond `keyring` - uses stdlib `urllib.request`
    - **Consistent CLI pattern** - argparse subcommands, JSON output
    
    ### Domains
    
    | Domain | Script | Tools |
    |--------|--------|-------|
    | Core | `core.py` | Projects, teams, identities (3) |
    | Work Items | `work_items.py` | CRUD, queries, comments, backlogs (20) |
    | Iterations | `work.py` | Sprints, capacity (7) |
    | Git/PRs | `repos.py` | Repos, branches, pull requests (18) |
    | Pipelines | `pipelines.py` | Builds, runs, artifacts (14) |
    | Search | `search.py` | Code, wiki, work item search (3) |
    | Wiki | `wiki.py` | Pages management (6) |
    | Test Plans | `test_plans.py` | Plans, suites, cases, results (9) |
    | Security | `security.py` | Advanced security alerts (2) |
    | Variable Groups | `variable_groups.py` | Pipeline variable groups (7) |
    | Environments | `environments.py` | Environments & approvals (8) |
    | Policies | `policies.py` | Branch policies (8) |
    | Attachments | `attachments.py` | Work item attachments (6) |
    
    ## Quick Start
    
    ### 1. Install dependency
    
    ```bash
    pip install keyring>=24.0.0
    ```
    
    ### 2. Authenticate
    
    **Option A: OAuth (Recommended)**
    ```bash
    cd skills/azure-devops
    python scripts/auth.py login --org MyOrganization
    # Follow the URL, enter the device code to authorize
    # Tokens auto-refresh - no need to re-login
    ```
    
    **Option B: PAT**
    
    Create a PAT at `https://dev.azure.com/{org}/_usersSettings/tokens` with scopes: Work Items (R&W), Code (R&W), Build (R&E), Wiki (R&W), Test Management (R&W), Advanced Security (R), Project and Team (R), Identity (R).
    
    ```bash
    cd skills/azure-devops
    python scripts/auth.py login --org MyOrganization --pat YOUR_PAT
    ```
    
    ### 3. Verify
    
    ```bash
    python scripts/auth.py status
    python scripts/core.py list-projects
    ```
    
    ## Usage
    
    All scripts follow the same pattern:
    
    ```bash
    python scripts/<domain>.py <command> --project <name> [options]
    ```
    
    Output is always JSON. Exit code 1 on errors.
    
    See [SKILL.md](SKILL.md) for complete command reference with examples.
    
    ## Troubleshooting
    
    **"Not authenticated" error**: Run `python scripts/auth.py login`
    
    **"HTTP 401"**: Token expired. For OAuth, run `python scripts/auth.py login --org <org>`. For PAT, create a new one and re-login.
    
    **"HTTP 403"**: PAT doesn't have the required scope for this operation.
    
    **"HTTP 404"**: Project, repo, or resource not found. Check the name/ID.
    
    **Keyring issues on Linux**: Install `secretstorage` package: `pip install secretstorage`
    
  • requirements.txt 16 B
    Loading…
  • SKILL.md 16.4 KB
    ---
    name: azure-devops
    description: |
      Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts,
      variable groups, environments/approvals, branch policies, and attachments. Use when user asks to: manage
      sprints, create/update work items, list repos, create PRs, run pipelines, search code, manage wiki pages,
      check security alerts, manage variable groups, approve deployments, or configure branch policies.
      Covers 13 domains with 99 tools via REST API.
    license: Apache-2.0
    metadata:
      author: sanjay3290
      version: "1.0"
    ---
    
    # Azure DevOps
    
    Full Azure DevOps integration using OAuth or PAT authentication and REST API v7.1.
    
    ## First-Time Setup
    
    ### Option 1: OAuth (Recommended)
    
    Login with OAuth device code flow (shows "Visual Studio Code" prompt):
    ```bash
    python scripts/auth.py login --org MyOrganization
    ```
    Follow the URL and enter the device code to authorize. Tokens auto-refresh.
    
    ### Option 2: PAT
    
    Login with a Personal Access Token:
    ```bash
    python scripts/auth.py login --org MyOrganization --pat YOUR_PAT
    ```
    
    Create a PAT at `https://dev.azure.com/{org}/_usersSettings/tokens` with these scopes:
    - **Work Items**: Read & Write
    - **Code**: Read & Write (for repos/PRs)
    - **Build**: Read & Execute (for pipelines)
    - **Wiki**: Read & Write
    - **Test Management**: Read & Write
    - **Advanced Security**: Read (for security alerts)
    - **Project and Team**: Read
    - **Identity**: Read (for user search)
    
    ### Common Commands
    
    Check authentication status:
    ```bash
    python scripts/auth.py status
    ```
    
    Logout:
    ```bash
    python scripts/auth.py logout
    ```
    
    ## Core (scripts/core.py)
    
    ```bash
    # List all projects
    python scripts/core.py list-projects
    python scripts/core.py list-projects --top 10
    
    # List teams in a project
    python scripts/core.py list-teams --project MyProject
    
    # Search for a user identity
    python scripts/core.py get-identity --search "john@example.com"
    ```
    
    ## Work Items (scripts/work_items.py)
    
    ```bash
    # Get a work item
    python scripts/work_items.py get --project MyProject --id 123
    python scripts/work_items.py get --project MyProject --id 123 --expand relations
    
    # Create a work item
    python scripts/work_items.py create --project MyProject --type "User Story" --title "New feature"
    python scripts/work_items.py create --project MyProject --type Bug --title "Fix login" \
      --field System.Description "Login fails on timeout" \
      --field System.AssignedTo "user@example.com"
    
    # Update a work item
    python scripts/work_items.py update --project MyProject --id 123 \
      --field System.State "Active" \
      --field System.AssignedTo "user@example.com"
    
    # Batch get multiple work items
    python scripts/work_items.py batch-get --project MyProject --ids 1,2,3
    
    # Add children to a parent
    python scripts/work_items.py add-children --project MyProject --parent-id 100 --child-ids 101,102
    
    # Link work items
    python scripts/work_items.py link --project MyProject --source-id 100 --target-id 200
    python scripts/work_items.py link --project MyProject --source-id 100 --target-id 200 \
      --link-type "System.LinkTypes.Dependency-Forward"
    
    # Remove a link
    python scripts/work_items.py unlink --project MyProject --source-id 100 --relation-index 0
    
    # Comments
    python scripts/work_items.py add-comment --project MyProject --id 123 --text "Working on this"
    python scripts/work_items.py list-comments --project MyProject --id 123
    
    # History
    python scripts/work_items.py get-revisions --project MyProject --id 123
    
    # List work item types
    python scripts/work_items.py list-types --project MyProject
    
    # My assigned items
    python scripts/work_items.py my-items --project MyProject
    
    # Items in an iteration
    python scripts/work_items.py iteration-items --project MyProject --iteration-path "MyProject\\Sprint 1"
    
    # Backlogs
    python scripts/work_items.py list-backlogs --project MyProject --team "MyProject Team"
    
    # Saved queries
    python scripts/work_items.py list-queries --project MyProject
    python scripts/work_items.py get-query --project MyProject --path "Shared Queries/Active Bugs"
    python scripts/work_items.py run-query --project MyProject --query-id "guid-here"
    
    # WIQL query
    python scripts/work_items.py run-wiql --project MyProject \
      --query "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active'"
    
    # Delete / recycle bin
    python scripts/work_items.py delete --project MyProject --id 999
    python scripts/work_items.py recycle-bin --project MyProject
    ```
    
    ## Git Repos & PRs (scripts/repos.py)
    
    ```bash
    # List repositories
    python scripts/repos.py list --project MyProject
    
    # Get repo details
    python scripts/repos.py get --project MyProject --repo my-repo
    
    # Branches
    python scripts/repos.py list-branches --project MyProject --repo my-repo
    python scripts/repos.py create-branch --project MyProject --repo my-repo --name feature/new --source main
    
    # Commits
    python scripts/repos.py search-commits --project MyProject --repo my-repo --path /src --author "john" --top 10
    
    # Pull requests
    python scripts/repos.py list-prs --project MyProject --repo my-repo
    python scripts/repos.py list-prs --project MyProject --status completed --top 5
    
    python scripts/repos.py create-pr --project MyProject --repo my-repo \
      --source feature/new --target main --title "Add new feature" --description "Details here"
    
    python scripts/repos.py get-pr --project MyProject --repo my-repo --pr-id 42
    
    python scripts/repos.py update-pr --project MyProject --repo my-repo --pr-id 42 --title "Updated title"
    
    # Reviewers
    python scripts/repos.py list-reviewers --project MyProject --repo my-repo --pr-id 42
    python scripts/repos.py add-reviewer --project MyProject --repo my-repo --pr-id 42 \
      --reviewer-id "guid" --vote 10
    
    # PR comments
    python scripts/repos.py list-threads --project MyProject --repo my-repo --pr-id 42
    python scripts/repos.py create-thread --project MyProject --repo my-repo --pr-id 42 \
      --content "Looks good!" --file-path "/src/main.py" --line 25
    python scripts/repos.py add-thread-comment --project MyProject --repo my-repo --pr-id 42 \
      --thread-id 1 --content "Fixed"
    
    # Complete or abandon PR
    python scripts/repos.py complete-pr --project MyProject --repo my-repo --pr-id 42
    python scripts/repos.py complete-pr --project MyProject --repo my-repo --pr-id 42 \
      --merge-strategy rebase --keep-source
    python scripts/repos.py abandon-pr --project MyProject --repo my-repo --pr-id 42
    
    # Diff
    python scripts/repos.py get-diff --project MyProject --repo my-repo --base main --target feature/new
    
    # Browse files
    python scripts/repos.py list-files --project MyProject --repo my-repo --path /src --branch main
    ```
    
    ## Iterations & Capacity (scripts/work.py)
    
    ```bash
    # List iterations
    python scripts/work.py list-iterations --project MyProject
    
    # Create iteration
    python scripts/work.py create-iteration --project MyProject --name "Sprint 5" \
      --start-date 2026-03-01 --finish-date 2026-03-14
    
    # Get iteration details
    python scripts/work.py get-iteration --project MyProject --iteration-id "guid"
    
    # Team iterations
    python scripts/work.py team-iterations --project MyProject --team "MyTeam" --timeframe current
    
    # Assign iteration to team
    python scripts/work.py assign-iteration --project MyProject --team "MyTeam" --iteration-id "guid"
    
    # Capacities
    python scripts/work.py get-capacities --project MyProject --team "MyTeam" --iteration-id "guid"
    python scripts/work.py set-capacity --project MyProject --team "MyTeam" --iteration-id "guid" \
      --member-id "user-guid" --activity Development --capacity-per-day 6
    ```
    
    ## Pipelines & Builds (scripts/pipelines.py)
    
    ```bash
    # Create pipeline
    python scripts/pipelines.py create --project MyProject --name "CI" \
      --repo-id "repo-guid" --yaml-path "/azure-pipelines.yml"
    
    # List builds
    python scripts/pipelines.py list-builds --project MyProject --top 5
    python scripts/pipelines.py list-builds --project MyProject --status completed --branch main
    
    # Get build details and logs
    python scripts/pipelines.py get-build --project MyProject --build-id 100
    python scripts/pipelines.py build-logs --project MyProject --build-id 100
    python scripts/pipelines.py build-logs --project MyProject --build-id 100 --log-id 3
    python scripts/pipelines.py build-changes --project MyProject --build-id 100
    
    # Pipeline definitions
    python scripts/pipelines.py list-definitions --project MyProject
    python scripts/pipelines.py list-definitions --project MyProject --name "CI"
    
    # Run a pipeline
    python scripts/pipelines.py run --project MyProject --pipeline-id 5 --branch develop
    python scripts/pipelines.py run --project MyProject --pipeline-id 5 \
      --variable ENV production --variable DEPLOY true
    
    # Pipeline runs
    python scripts/pipelines.py get-run --project MyProject --pipeline-id 5 --run-id 200
    python scripts/pipelines.py list-runs --project MyProject --pipeline-id 5 --top 10
    
    # Stage management
    python scripts/pipelines.py update-stage --project MyProject --build-id 100 --stage Deploy --state retry
    
    # Artifacts
    python scripts/pipelines.py get-artifacts --project MyProject --build-id 100
    
    # Queue and cancel builds
    python scripts/pipelines.py queue-build --project MyProject --definition-id 10 --branch main
    python scripts/pipelines.py cancel-build --project MyProject --build-id 100
    
    # Latest build status
    python scripts/pipelines.py build-status --project MyProject --definition-id 10
    ```
    
    ## Search (scripts/search.py)
    
    ```bash
    # Search code
    python scripts/search.py code --project MyProject --query "TODO"
    python scripts/search.py code --project MyProject --query "connectionString" --top 10
    
    # Search wiki
    python scripts/search.py wiki --project MyProject --query "deployment guide"
    
    # Search work items
    python scripts/search.py work-items --project MyProject --query "login bug"
    ```
    
    ## Wiki (scripts/wiki.py)
    
    ```bash
    # List wikis
    python scripts/wiki.py list --project MyProject
    
    # Get wiki details
    python scripts/wiki.py get --project MyProject --wiki-id MyProject.wiki
    
    # List pages
    python scripts/wiki.py list-pages --project MyProject --wiki-id MyProject.wiki
    python scripts/wiki.py list-pages --project MyProject --wiki-id MyProject.wiki --path /Architecture
    
    # Get page content
    python scripts/wiki.py get-page --project MyProject --wiki-id MyProject.wiki --path /Home
    python scripts/wiki.py get-page-content --project MyProject --wiki-id MyProject.wiki --path /Home
    
    # Create or update a page
    python scripts/wiki.py create-or-update-page --project MyProject --wiki-id MyProject.wiki \
      --path /NewPage --content "# New Page\n\nContent here"
    ```
    
    ## Test Plans (scripts/test_plans.py)
    
    ```bash
    # Test plans
    python scripts/test_plans.py list-plans --project MyProject
    python scripts/test_plans.py get-plan --project MyProject --plan-id 1
    python scripts/test_plans.py create-plan --project MyProject --name "Release 2.0 Tests"
    
    # Test suites
    python scripts/test_plans.py list-suites --project MyProject --plan-id 1
    python scripts/test_plans.py get-suite --project MyProject --plan-id 1 --suite-id 2
    
    # Test cases
    python scripts/test_plans.py list-test-cases --project MyProject --plan-id 1 --suite-id 2
    python scripts/test_plans.py add-test-cases --project MyProject --plan-id 1 --suite-id 2 --ids 100,101
    
    # Test results
    python scripts/test_plans.py list-results --project MyProject --run-id 50
    python scripts/test_plans.py get-result --project MyProject --run-id 50 --result-id 1
    ```
    
    ## Advanced Security (scripts/security.py)
    
    ```bash
    # List security alerts
    python scripts/security.py list-alerts --project MyProject --repo my-repo
    python scripts/security.py list-alerts --project MyProject --repo my-repo \
      --state active --severity high --type dependency
    
    # Get alert details
    python scripts/security.py get-alert --project MyProject --repo my-repo --alert-id 42
    ```
    
    ## Variable Groups (scripts/variable_groups.py)
    
    ```bash
    # List variable groups
    python scripts/variable_groups.py list --project MyProject
    
    # Get a variable group
    python scripts/variable_groups.py get --project MyProject --id 1
    
    # Create a variable group
    python scripts/variable_groups.py create --project MyProject --name "Deploy Vars" \
      --variable ENV production --variable REGION eastus --description "Deploy config"
    
    # Update a variable group
    python scripts/variable_groups.py update --project MyProject --id 1 --name "New Name" \
      --variable ENV staging
    
    # Add/update a single variable (supports --secret for sensitive values)
    python scripts/variable_groups.py add-variable --project MyProject --id 1 \
      --key API_KEY --value "secret123" --secret
    
    # Remove a variable
    python scripts/variable_groups.py remove-variable --project MyProject --id 1 --key OLD_VAR
    
    # Delete a variable group
    python scripts/variable_groups.py delete --project MyProject --id 1
    ```
    
    ## Environments & Approvals (scripts/environments.py)
    
    ```bash
    # List environments
    python scripts/environments.py list --project MyProject
    
    # Create an environment
    python scripts/environments.py create --project MyProject --name "Production" \
      --description "Production environment"
    
    # Get environment details
    python scripts/environments.py get --project MyProject --id 1
    
    # List checks/approvals configured on an environment
    python scripts/environments.py list-checks --project MyProject --id 1
    
    # List pending approvals
    python scripts/environments.py list-approvals --project MyProject
    python scripts/environments.py list-approvals --project MyProject --state all
    
    # Approve/reject
    python scripts/environments.py approve --project MyProject --approval-id "guid" \
      --comment "Looks good"
    python scripts/environments.py reject --project MyProject --approval-id "guid" \
      --comment "Needs fixes"
    
    # Delete an environment
    python scripts/environments.py delete --project MyProject --id 1
    ```
    
    ## Branch Policies (scripts/policies.py)
    
    ```bash
    # List all policies
    python scripts/policies.py list --project MyProject
    python scripts/policies.py list --project MyProject --branch main --repo my-repo-id
    
    # Get a policy
    python scripts/policies.py get --project MyProject --id 1
    
    # List available policy types
    python scripts/policies.py list-types --project MyProject
    
    # Create minimum reviewers policy
    python scripts/policies.py create-min-reviewers --project MyProject \
      --repo-id "repo-guid" --branch main --min-reviewers 2 --reset-on-push
    
    # Create build validation policy
    python scripts/policies.py create-build-policy --project MyProject \
      --repo-id "repo-guid" --branch main --build-definition-id 10
    
    # Update a policy (enable/disable/blocking)
    python scripts/policies.py update --project MyProject --id 1 --enabled false
    python scripts/policies.py update --project MyProject --id 1 --blocking true
    
    # List policy evaluations for a PR
    python scripts/policies.py list-evaluations --project MyProject --pr-id 42
    
    # Delete a policy
    python scripts/policies.py delete --project MyProject --id 1
    ```
    
    ## Work Item Attachments (scripts/attachments.py)
    
    ```bash
    # Upload a file
    python scripts/attachments.py upload --project MyProject --file ./report.pdf
    
    # Attach an uploaded file to a work item
    python scripts/attachments.py attach --project MyProject --id 123 \
      --url "https://dev.azure.com/org/project/_apis/wit/attachments/guid" \
      --comment "Test report"
    
    # Upload and attach in one step
    python scripts/attachments.py upload-and-attach --project MyProject --id 123 \
      --file ./screenshot.png --comment "Bug screenshot"
    
    # List attachments on a work item
    python scripts/attachments.py list --project MyProject --id 123
    
    # Download an attachment
    python scripts/attachments.py download --project MyProject \
      --url "https://dev.azure.com/org/project/_apis/wit/attachments/guid" \
      --output ./downloaded.pdf
    
    # Remove an attachment by relation index
    python scripts/attachments.py remove --project MyProject --id 123 --index 0
    ```
    
    ## Common Work Item Fields
    
    | Field | Reference Name |
    |-------|---------------|
    | Title | `System.Title` |
    | State | `System.State` |
    | Assigned To | `System.AssignedTo` |
    | Description | `System.Description` |
    | Area Path | `System.AreaPath` |
    | Iteration Path | `System.IterationPath` |
    | Priority | `Microsoft.VSTS.Common.Priority` |
    | Story Points | `Microsoft.VSTS.Scheduling.StoryPoints` |
    | Tags | `System.Tags` |
    | Repro Steps | `Microsoft.VSTS.TCM.ReproSteps` |
    | Acceptance Criteria | `Microsoft.VSTS.Common.AcceptanceCriteria` |
    
    ## Link Types
    
    | Link Type | Reference Name |
    |-----------|---------------|
    | Related | `System.LinkTypes.Related` |
    | Parent → Child | `System.LinkTypes.Hierarchy-Forward` |
    | Child → Parent | `System.LinkTypes.Hierarchy-Reverse` |
    | Predecessor | `System.LinkTypes.Dependency-Forward` |
    | Successor | `System.LinkTypes.Dependency-Reverse` |
    
    ## Token Management
    
    Credentials stored securely using the system keyring:
    - **macOS**: Keychain
    - **Windows**: Windows Credential Locker
    - **Linux**: Secret Service API
    
    Service name: `azure-devops-skill`
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.