mfse-azure-devops-cli-boards

Files (2)

• SKILL.md
• cli-examples.md · references/

SKILL.md (first lines)

---
name:  mfse-azure-devops-cli-boards
description: 'Manage Azure DevOps boards using CLI commands. Use when: creating, updating, or querying work items, boards, and sprints. Generates complete, properly formatted CLI commands for Azure DevOps.'
argument-hint: 'Write this work item to azure devops'
user-invocable: true
---

This Skill helps manage Azure DevOps resources using the Azure CLI with Azure DevOps extension.
 

## Prerequisites

Install Azure CLI and Azure DevOps extension:

```bash
# Install Azure CLI
brew install azure-cli  # macOS
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash  # Linux
pip install azure-cli  # via pip

# Verify installation
az --version

# Install Azure DevOps extension
az extension add --name azure-devops
az extension show --name azure-devops
```

 

## Authentication

### Login to Azure DevOps

```bash
# Interactive login (prompts for PAT)
az devops login --organization https://dev.azure.com/{org}

# Login with PAT token
az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN
```

> **Note:** Use `az boards` for work item operations and `az devops` for organization/project-level operations. Common error: `work-item` is not a subcommand of `az devops`, use `az boards work-item` instead.

### Configure Defaults

```bash
# Set default organization and project
az devops configure --defaults organization=https://dev.azure.com/{org} project={project}

# List current configuration
az devops configure --list

# Enable Git aliases
az devops configure --use-git-aliases true
```
 
## Projects

### List Projects

```bash
az devops project list --organization https://dev.azure.com/{org}
az devops project list --top 10 --output table
```
 

### Show Project Details

```bash
az devops project show --project {project-name} --org https://dev.azure.com/{org}
```
 
## Work Items (Boards)

### Query Work Items

```bash
# WIQL query
az boards query \
  --wiql "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] = 'Active'"

# Query with output format
az boards query --wiql "SELECT * FROM WorkItems" --output table
```

### Show Work Item

```bash
az boards work-item show --id {work-item-id}
az boards work-item show --id {work-item-id} --open
```

### Create Work Item

```bash
# Basic work item
az boards work-item create \
  --title "Fix login bug" \
  --type Bug \
  --assigned-to user@example.com \
  --description "Users cannot login with SSO"

# With area and iteration
az boards work-item create \
  --title "New feature" \
  --type "User Story" \
  --area "Project\\Area1" \
  --iteration "Project\\Sprint 1"

# With custom fields
az boards work-item create \
  --title "Task" \
  --type Task \
  --fields "Priority=1" "Severity=2"

# With discussion comment
az boards work-item create \
  --title "Issue" \
  --type Bug \

From MFSoftwareEngineering/mfse-softwarefactory, MIT.

More from MFSoftwareEngineering/mfse-softwarefactory