devskill 2.0.7 → 2.0.8

package/skills/azure-devops-cli/references/repos-and-prs.md

@@ -0,0 +1,333 @@
+# Repositories & Pull Requests
+
+## Table of Contents
+- [Repositories](#repositories)
+- [Repository Import](#repository-import)
+- [Pull Requests](#pull-requests)
+- [Git References](#git-references)
+- [Repository Policies](#repository-policies)
+
+---
+
+## Repositories
+
+### List Repositories
+
+```bash
+az repos list --org https://dev.azure.com/{org} --project {project}
+az repos list --output table
+```
+
+### Show Repository Details
+
+```bash
+az repos show --repository {repo-name} --project {project}
+```
+
+### Create Repository
+
+```bash
+az repos create --name {repo-name} --project {project}
+```
+
+### Delete Repository
+
+```bash
+az repos delete --id {repo-id} --project {project} --yes
+```
+
+### Update Repository
+
+```bash
+az repos update --id {repo-id} --name {new-name} --project {project}
+```
+
+## Repository Import
+
+### Import Git Repository
+
+```bash
+# Import from public Git repository
+az repos import create \
+  --git-source-url https://github.com/user/repo \
+  --repository {repo-name}
+
+# Import with authentication
+az repos import create \
+  --git-source-url https://github.com/user/private-repo \
+  --repository {repo-name} \
+  --user {username} \
+  --password {password-or-pat}
+```
+
+## Pull Requests
+
+### Create Pull Request
+
+```bash
+# Basic PR creation
+az repos pr create \
+  --repository {repo} \
+  --source-branch {source-branch} \
+  --target-branch {target-branch} \
+  --title "PR Title" \
+  --description "PR description" \
+  --open
+
+# PR with work items
+az repos pr create \
+  --repository {repo} \
+  --source-branch {source-branch} \
+  --work-items 63 64
+
+# Draft PR with reviewers
+az repos pr create \
+  --repository {repo} \
+  --source-branch feature/new-feature \
+  --target-branch main \
+  --title "Feature: New functionality" \
+  --draft true \
+  --reviewers user1@example.com user2@example.com \
+  --required-reviewers lead@example.com \
+  --labels "enhancement" "backlog"
+```
+
+### List Pull Requests
+
+```bash
+# All PRs
+az repos pr list --repository {repo}
+
+# Filter by status
+az repos pr list --repository {repo} --status active
+
+# Filter by creator
+az repos pr list --repository {repo} --creator {email}
+
+# Output as table
+az repos pr list --repository {repo} --output table
+```
+
+### Show PR Details
+
+```bash
+az repos pr show --id {pr-id}
+az repos pr show --id {pr-id} --open  # Open in browser
+```
+
+### Update PR (Complete/Abandon/Draft)
+
+```bash
+# Complete PR
+az repos pr update --id {pr-id} --status completed
+
+# Abandon PR
+az repos pr update --id {pr-id} --status abandoned
+
+# Set to draft
+az repos pr update --id {pr-id} --draft true
+
+# Publish draft PR
+az repos pr update --id {pr-id} --draft false
+
+# Auto-complete when policies pass
+az repos pr update --id {pr-id} --auto-complete true
+
+# Set title and description
+az repos pr update --id {pr-id} --title "New title" --description "New description"
+```
+
+### Checkout PR Locally
+
+```bash
+# Checkout PR branch
+az repos pr checkout --id {pr-id}
+
+# Checkout with specific remote
+az repos pr checkout --id {pr-id} --remote-name upstream
+```
+
+### Vote on PR
+
+```bash
+az repos pr set-vote --id {pr-id} --vote approve
+az repos pr set-vote --id {pr-id} --vote approve-with-suggestions
+az repos pr set-vote --id {pr-id} --vote reject
+az repos pr set-vote --id {pr-id} --vote wait-for-author
+az repos pr set-vote --id {pr-id} --vote reset
+```
+
+### PR Reviewers
+
+```bash
+# Add reviewers
+az repos pr reviewer add --id {pr-id} --reviewers user1@example.com user2@example.com
+
+# List reviewers
+az repos pr reviewer list --id {pr-id}
+
+# Remove reviewers
+az repos pr reviewer remove --id {pr-id} --reviewers user1@example.com
+```
+
+### PR Work Items
+
+```bash
+# Add work items to PR
+az repos pr work-item add --id {pr-id} --work-items {id1} {id2}
+
+# List PR work items
+az repos pr work-item list --id {pr-id}
+
+# Remove work items from PR
+az repos pr work-item remove --id {pr-id} --work-items {id1}
+```
+
+### PR Policies
+
+```bash
+# List policies for a PR
+az repos pr policy list --id {pr-id}
+
+# Queue policy evaluation for a PR
+az repos pr policy queue --id {pr-id} --evaluation-id {evaluation-id}
+```
+
+## Git References
+
+### List References (Branches)
+
+```bash
+az repos ref list --repository {repo}
+az repos ref list --repository {repo} --query "[?name=='refs/heads/main']"
+```
+
+### Create Reference (Branch)
+
+```bash
+az repos ref create --name refs/heads/new-branch --object-type commit --object {commit-sha}
+```
+
+### Delete Reference (Branch)
+
+```bash
+az repos ref delete --name refs/heads/old-branch --repository {repo} --project {project}
+```
+
+### Lock/Unlock Branch
+
+```bash
+az repos ref lock --name refs/heads/main --repository {repo} --project {project}
+az repos ref unlock --name refs/heads/main --repository {repo} --project {project}
+```
+
+## Repository Policies
+
+### List All Policies
+
+```bash
+az repos policy list --repository {repo-id} --branch main
+```
+
+### Create/Update/Delete Policy
+
+```bash
+# Create from config file
+az repos policy create --config policy.json
+
+# Update
+az repos policy update --id {policy-id} --config updated-policy.json
+
+# Delete
+az repos policy delete --id {policy-id} --yes
+```
+
+### Approver Count Policy
+
+```bash
+az repos policy approver-count create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id} \
+  --minimum-approver-count 2 \
+  --creator-vote-counts true
+```
+
+### Build Policy
+
+```bash
+az repos policy build create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id} \
+  --build-definition-id {definition-id} \
+  --queue-on-source-update-only true \
+  --valid-duration 720
+```
+
+### Work Item Linking Policy
+
+```bash
+az repos policy work-item-linking create \
+  --blocking true \
+  --branch main \
+  --enabled true \
+  --repository-id {repo-id}
+```
+
+### Required Reviewer Policy
+
+```bash
+az repos policy required-reviewer create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id} \
+  --required-reviewers user@example.com
+```
+
+### Merge Strategy Policy
+
+```bash
+az repos policy merge-strategy create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id} \
+  --allow-squash true \
+  --allow-rebase true \
+  --allow-no-fast-forward true
+```
+
+### Case Enforcement Policy
+
+```bash
+az repos policy case-enforcement create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id}
+```
+
+### Comment Required Policy
+
+```bash
+az repos policy comment-required create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id}
+```
+
+### File Size Policy
+
+```bash
+az repos policy file-size create \
+  --blocking true \
+  --enabled true \
+  --branch main \
+  --repository-id {repo-id} \
+  --maximum-file-size 10485760  # 10MB in bytes
+```

package/skills/azure-devops-cli/references/variables-and-agents.md

@@ -0,0 +1,212 @@
+# Pipeline Variables, Variable Groups & Agents
+
+## Table of Contents
+- [Pipeline Variables](#pipeline-variables)
+- [Variable Groups](#variable-groups)
+- [Pipeline Folders](#pipeline-folders)
+- [Agent Pools](#agent-pools)
+- [Agent Queues](#agent-queues)
+- [Agents](#agents)
+
+---
+
+## Pipeline Variables
+
+### List Variables
+
+```bash
+az pipelines variable list --pipeline-id {pipeline-id}
+```
+
+### Create Variable
+
+```bash
+# Non-secret variable
+az pipelines variable create \
+  --name {var-name} \
+  --value {var-value} \
+  --pipeline-id {pipeline-id}
+
+# Secret variable
+az pipelines variable create \
+  --name {var-name} \
+  --secret true \
+  --pipeline-id {pipeline-id}
+
+# Secret with prompt
+az pipelines variable create \
+  --name {var-name} \
+  --secret true \
+  --prompt true \
+  --pipeline-id {pipeline-id}
+```
+
+### Update Variable
+
+```bash
+az pipelines variable update \
+  --name {var-name} \
+  --value {new-value} \
+  --pipeline-id {pipeline-id}
+
+# Update secret variable
+az pipelines variable update \
+  --name {var-name} \
+  --secret true \
+  --value "{new-secret-value}" \
+  --pipeline-id {pipeline-id}
+```
+
+### Delete Variable
+
+```bash
+az pipelines variable delete --name {var-name} --pipeline-id {pipeline-id} --yes
+```
+
+## Variable Groups
+
+### List Variable Groups
+
+```bash
+az pipelines variable-group list
+az pipelines variable-group list --output table
+```
+
+### Show Variable Group
+
+```bash
+az pipelines variable-group show --id {group-id}
+```
+
+### Create Variable Group
+
+```bash
+az pipelines variable-group create \
+  --name {group-name} \
+  --variables key1=value1 key2=value2 \
+  --authorize true
+```
+
+### Update Variable Group
+
+```bash
+az pipelines variable-group update \
+  --id {group-id} \
+  --name {new-name} \
+  --description "Updated description"
+```
+
+### Delete Variable Group
+
+```bash
+az pipelines variable-group delete --id {group-id} --yes
+```
+
+### Variable Group Variables
+
+```bash
+# List variables
+az pipelines variable-group variable list --group-id {group-id}
+
+# Create non-secret variable
+az pipelines variable-group variable create \
+  --group-id {group-id} \
+  --name {var-name} \
+  --value {var-value}
+
+# Create secret variable (will prompt for value if not provided)
+az pipelines variable-group variable create \
+  --group-id {group-id} \
+  --name {var-name} \
+  --secret true
+
+# Create secret with environment variable
+export AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret=secretvalue
+az pipelines variable-group variable create \
+  --group-id {group-id} \
+  --name MySecret \
+  --secret true
+
+# Update variable
+az pipelines variable-group variable update \
+  --group-id {group-id} \
+  --name {var-name} \
+  --value {new-value} \
+  --secret false
+
+# Delete variable
+az pipelines variable-group variable delete \
+  --group-id {group-id} \
+  --name {var-name}
+```
+
+## Pipeline Folders
+
+### List Folders
+
+```bash
+az pipelines folder list
+```
+
+### Create Folder
+
+```bash
+az pipelines folder create --path 'folder/subfolder' --description "My folder"
+```
+
+### Delete Folder
+
+```bash
+az pipelines folder delete --path 'folder/subfolder'
+```
+
+### Update Folder
+
+```bash
+az pipelines folder update --path 'old-folder' --new-path 'new-folder'
+```
+
+## Agent Pools
+
+### List Agent Pools
+
+```bash
+az pipelines pool list
+az pipelines pool list --pool-type automation
+az pipelines pool list --pool-type deployment
+```
+
+### Show Agent Pool
+
+```bash
+az pipelines pool show --pool-id {pool-id}
+```
+
+## Agent Queues
+
+### List Agent Queues
+
+```bash
+az pipelines queue list
+az pipelines queue list --pool-name {pool-name}
+```
+
+### Show Agent Queue
+
+```bash
+az pipelines queue show --id {queue-id}
+```
+
+## Agents
+
+### List Agents in Pool
+
+```bash
+az pipelines agent list --pool-id {pool-id}
+```
+
+### Show Agent Details
+
+```bash
+az pipelines agent show --agent-id {agent-id} --pool-id {pool-id}
+```