Azure DevOps 自动化工具：工作项、代码仓库、流水线、制品全面集成指南

azure-devops by rysweet/amplihack

106 周安装量

44 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/rysweet/amplihack --skill azure-devops

项目管理自动化开发运维

🇨🇳中文介绍

Azure DevOps 技能

完整的 Azure DevOps 集成，涵盖工作项、代码仓库、流水线和制品。

自动激活时机： 当用户提及 Azure DevOps、ADO、工作项、工作项板、代码仓库、流水线、制品或 Azure DevOps URL 时。

目的

本技能通过专门构建的 Python CLI 工具，为 Azure DevOps 自动化提供全面指导，这些工具可处理：

工作项（工作项板）

创建带有 HTML 格式描述的工作项
更新工作项（状态、分配、字段）
删除工作项（需确认）
链接父子关系
执行 WIQL 查询
发现工作项类型和字段

代码仓库

列出代码仓库及其详细信息
创建包含审阅者和工作项的拉取请求
分支验证
获取克隆 URL

流水线

列出和执行流水线
构建监控和日志查看
部署管理

制品

包源管理
包发布和下载
版本管理

快速开始

1. 先进行身份验证

务必首先检查身份验证：

python .claude/scenarios/az-devops-tools/auth_check.py --auto-fix

此命令验证 Azure CLI 是否已安装、您是否已登录、组织和项目是否已配置，以及您是否拥有访问权限。

参见：[@authentication.md]

2. 常见操作

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

渐进式加载参考

有关特定操作的详细指导，请参阅：

[@authentication.md] - 身份验证方法（PAT、OAuth、环境变量）
[@work-items.md] - 工作项 CRUD 操作、字段更新、状态转换
[@queries.md] - WIQL 查询模式、筛选、排序
[@html-formatting.md] - 工作项描述/评论中的 HTML 格式化
[@repos.md] - 代码仓库操作、拉取请求工作流
[@pipelines.md] - 流水线触发、构建监控、部署
[@artifacts.md] - 包管理、制品发布
[@HOW_TO_CREATE_YOUR_OWN.md] - 创建类似集成工具的模板

工具	目的	使用时机
`auth_check.py`	验证身份验证	在任何操作之前
`create_work_item.py`	创建工作项	添加用户故事、任务、缺陷等
`update_work_item.py`	更新工作项	更改状态、分配人、字段
`delete_work_item.py`	删除工作项	移除工作项（需确认）
`get_work_item.py`	获取工作项详情	查看完整的工作项信息
`list_work_items.py`	查询工作项	查找、筛选和列出工作项
`link_parent.py`	链接父子关系	创建史诗 → 功能 → 故事层次结构
`query_wiql.py`	执行 WIQL 查询	使用 WIQL 进行复杂筛选
`format_html.py`	转换为 HTML	格式化富文本描述
`list_types.py`	发现类型/字段	探索可用选项
`list_repos.py`	列出代码仓库	查看项目中的所有代码仓库
`create_pr.py`	创建拉取请求	提交代码以供审阅

模式 1：创建带有父项的工作项

# 创建父工作项
python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Epic" \
  --title "第一季度规划计划" \
  --description @epic_desc.md

# 输出：已创建工作项 #12345

# 创建子项并链接到父项
python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Feature" \
  --title "认证系统" \
  --description @feature_desc.md \
  --parent-id 12345

# 输出：已创建工作项 #12346 并链接到父项 #12345

模式 2：查询和更新工作项

# 查找您的活动工作项
python .claude/scenarios/az-devops-tools/list_work_items.py \
  --query mine \
  --format ids-only

# 更新工作项状态
python .claude/scenarios/az-devops-tools/update_work_item.py \
  --id 12345 \
  --state "Active" \
  --comment "开始处理此项工作"

模式 3：从功能分支到拉取请求

# 列出代码仓库
python .claude/scenarios/az-devops-tools/list_repos.py

# 创建拉取请求
python .claude/scenarios/az-devops-tools/create_pr.py \
  --source feature/auth \
  --target main \
  --title "添加认证" \
  --description @pr_desc.md \
  --reviewers "user1@domain.com,user2@domain.com" \
  --work-items "12345,12346"

模式 4：发现可用类型

# 列出项目中所有工作项类型
python .claude/scenarios/az-devops-tools/list_types.py

# 显示特定类型的字段
python .claude/scenarios/az-devops-tools/list_types.py \
  --type "User Story" \
  --fields

需要 HTML 格式化

Azure DevOps 工作项描述使用 HTML，而非 Markdown 或纯文本。

工具会自动处理此问题：

create_work_item.py 默认将 markdown 转换为 HTML
使用 --no-html 禁用转换
或者直接使用 format_html.py 进行自定义格式化

参见：[@html-formatting.md]

您无法在通过 CLI 创建工作项时指定父项（Azure 限制）。

工具提供了两种方法：

选项 A： 使用 --parent-id 标志（推荐）：

python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Task" \
  --title "我的任务" \
  --parent-id 12345

选项 B： 单独链接：

# 步骤 1：创建
TASK_ID=$(python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Task" \
  --title "我的任务" \
  --json | jq -r '.id')

# 步骤 2：链接
python .claude/scenarios/az-devops-tools/link_parent.py \
  --child $TASK_ID \
  --parent 12345

区域路径和工作项类型

区域路径格式：项目名称\团队名称\子区域
工作项类型因项目而异（标准类型 + 自定义类型）
使用 list_types.py 来发现您的项目中可用的内容

错误	使用的工具	示例
身份验证失败	`auth_check.py --auto-fix`	自动登录和配置
无效的工作项类型	`list_types.py`	查看可用类型
字段验证错误	`list_types.py --type "Type" --fields`	查看有效字段
父项链接失败	检查 ID 是否存在，验证层次结构规则	史诗 → 功能 → 故事 → 任务
分支不存在	使用 `git branch -a` 验证	先推送分支

所有工具都位于 ~/.amplihack/.claude/scenarios/az-devops-tools/：

独立的 Python 程序（可独立运行）
可导入的模块（可在其他脚本中使用）
全面的错误处理
测试位于 tests/ 目录

参见：工具 README

这些工具遵循 amplihack 原则：

极致简洁：每个工具都专注于做好一件事
零废话：每个功能都有效，没有存根或待办事项
可重用：可导入和组合
快速失败：提供清晰、可操作的错误指导
自包含：仅使用标准库 + azure CLI 包装器

# 设置（首次使用）
python .claude/scenarios/az-devops-tools/auth_check.py --auto-fix

# 创建工作项
python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "User Story" \
  --title "标题" \
  --description @desc.md

# 更新工作项
python .claude/scenarios/az-devops-tools/update_work_item.py \
  --id 12345 \
  --state "Active"

# 查询工作项
python .claude/scenarios/az-devops-tools/list_work_items.py --query mine

# 创建拉取请求
python .claude/scenarios/az-devops-tools/create_pr.py \
  --source feature/branch \
  --target main \
  --title "添加功能"

# 发现类型
python .claude/scenarios/az-devops-tools/list_types.py

🇺🇸English

Azure DevOps Skill

Complete Azure DevOps integration covering boards, repositories, pipelines, and artifacts.

Auto-activates when: User mentions Azure DevOps, ADO, work items, boards, repos, pipelines, artifacts, or Azure DevOps URLs.

Purpose

This skill provides comprehensive guidance for Azure DevOps automation through purpose-built Python CLI tools that handle:

Work Items (Boards)

Work item creation with HTML-formatted descriptions
Work item updates (state, assignments, fields)
Work item deletion with confirmation
Parent-child relationship linking
WIQL query execution
Work item type and field discovery

Repositories

Repository listing with details
Pull request creation with reviewers and work items
Branch validation
Clone URL access

Pipelines

Pipeline listing and execution
Build monitoring and logs
Deployment management

Artifacts

Package feed management
Package publishing and downloading
Version management

Quick Start

1. Authentication First

ALWAYS start by checking authentication:

python .claude/scenarios/az-devops-tools/auth_check.py --auto-fix

This verifies Azure CLI is installed, you're logged in, org/project are configured, and you have access.

See: [@authentication.md]

2. Common Operations

Create Work Item

python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "User Story" \
  --title "Implement feature" \
  --description @story.md

Query Work Items

python .claude/scenarios/az-devops-tools/list_work_items.py --query mine

Create Pull Request

python .claude/scenarios/az-devops-tools/create_pr.py \
  --source feature/branch \
  --target main \
  --title "Add feature"

Progressive Loading References

For detailed guidance on specific operations, see:

[@authentication.md] - Authentication methods (PAT, OAuth, environment variables)
[@work-items.md] - Work item CRUD operations, field updates, state transitions
[@queries.md] - WIQL query patterns, filtering, sorting
[@html-formatting.md] - HTML formatting in work item descriptions/comments
[@repos.md] - Repository operations, pull request workflows
[@pipelines.md] - Pipeline triggers, build monitoring, deployment
[@artifacts.md] - Package management, artifact publishing
[@HOW_TO_CREATE_YOUR_OWN.md] - Template for creating similar integration tools

Available Tools

Tool	Purpose	When to Use
`auth_check.py`	Verify authentication	Before any operations
`create_work_item.py`	Create work items	Add User Stories, Tasks, Bugs, etc.
`update_work_item.py`	Update work items	Change state, assignee, fields
`delete_work_item.py`	Delete work items	Remove work items (with confirmation)
`get_work_item.py`

Common Patterns

Pattern 1: Create Work Item with Parent

# Create parent work item
python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Epic" \
  --title "Q1 Planning Initiative" \
  --description @epic_desc.md

# Output: Created work item #12345

# Create child and link to parent
python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Feature" \
  --title "Authentication System" \
  --description @feature_desc.md \
  --parent-id 12345

# Output: Created work item #12346 and linked to parent #12345

Pattern 2: Query and Update Work Items

# Find your active work items
python .claude/scenarios/az-devops-tools/list_work_items.py \
  --query mine \
  --format ids-only

# Update work item state
python .claude/scenarios/az-devops-tools/update_work_item.py \
  --id 12345 \
  --state "Active" \
  --comment "Starting work on this"

Pattern 3: Feature Branch to Pull Request

# List repositories
python .claude/scenarios/az-devops-tools/list_repos.py

# Create pull request
python .claude/scenarios/az-devops-tools/create_pr.py \
  --source feature/auth \
  --target main \
  --title "Add authentication" \
  --description @pr_desc.md \
  --reviewers "user1@domain.com,user2@domain.com" \
  --work-items "12345,12346"

Pattern 4: Discover Available Types

# List all work item types in your project
python .claude/scenarios/az-devops-tools/list_types.py

# Show fields for specific type
python .claude/scenarios/az-devops-tools/list_types.py \
  --type "User Story" \
  --fields

Critical Learnings

HTML Formatting Required

Azure DevOps work item descriptions use HTML, not Markdown or plain text.

The tools handle this automatically:

create_work_item.py converts markdown to HTML by default
Use --no-html to disable conversion
Or use format_html.py directly for custom formatting

See: [@html-formatting.md]

Two-Step Parent Linking

You cannot specify a parent during work item creation via CLI (Azure limitation).

The tools provide two approaches:

Option A: Use --parent-id flag (recommended):

python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Task" \
  --title "My Task" \
  --parent-id 12345

Option B: Link separately:

# Step 1: Create
TASK_ID=$(python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "Task" \
  --title "My Task" \
  --json | jq -r '.id')

# Step 2: Link
python .claude/scenarios/az-devops-tools/link_parent.py \
  --child $TASK_ID \
  --parent 12345

Area Path and Work Item Types

Area path format: ProjectName\TeamName\SubArea
Work item types vary by project (standard + custom types)
Use list_types.py to discover what's available in your project

Error Recovery

Error	Tool to Use	Example
Authentication failed	`auth_check.py --auto-fix`	Auto-login and configure
Invalid work item type	`list_types.py`	See available types
Field validation error	`list_types.py --type "Type" --fields`	See valid fields
Parent link failed	Check IDs exist, verify hierarchy rules	Epic → Feature → Story → Task
Branch does not exist	Verify with `git branch -a`	Push branch first

Tool Implementation

All tools are in ~/.amplihack/.claude/scenarios/az-devops-tools/:

Standalone Python programs (can run independently)
Importable modules (can use in other scripts)
Comprehensive error handling
Tests in tests/ directory

See: Tool README

Philosophy

These tools follow amplihack principles:

Ruthless Simplicity : Each tool does one thing well
Zero-BS : Every function works, no stubs or TODOs
Reusable : Importable and composable
Fail-Fast : Clear errors with actionable guidance
Self-Contained : Standard library + azure CLI wrapper only

Quick Reference

# Setup (first time)
python .claude/scenarios/az-devops-tools/auth_check.py --auto-fix

# Create work item
python .claude/scenarios/az-devops-tools/create_work_item.py \
  --type "User Story" \
  --title "Title" \
  --description @desc.md

# Update work item
python .claude/scenarios/az-devops-tools/update_work_item.py \
  --id 12345 \
  --state "Active"

# Query work items
python .claude/scenarios/az-devops-tools/list_work_items.py --query mine

# Create pull request
python .claude/scenarios/az-devops-tools/create_pr.py \
  --source feature/branch \
  --target main \
  --title "Add feature"

# Discover types
python .claude/scenarios/az-devops-tools/list_types.py

Weekly Installs

Repository

rysweet/amplihack

GitHub Stars

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode92

codex87

cursor86

gemini-cli85

claude-code85

github-copilot83

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

138,800 周安装