用途:该技能用于通过 az CLI 与 Azure DevOps REST API 与 Azure DevOps 资源交互,主要面向仓库管理与拉取请求(PR)相关操作。
主要能力:包括项目列表与详情、仓库创建/删除/列表/查看/获取克隆 URL;PR 的创建、列表、查看、更新、完成(合并)、放弃、投票;PR 评论与线程的 REST API 读写;服务连接列表、详情、按名称查询、删除、WIF 详情获取与授权;代理池列表、详情、创建、删除;代理列表与在线筛选;队列列表、创建、授权;管道列表、创建、删除、运行、运行状态查看,以及构建时间线与日志入口。
认证与前置条件:通过环境变量 $AZURE_DEVOPS_EXT_PAT 认证,无需登录。仓库操作要求 ADO remote(dev.azure.com 或 visualstudio.com)。默认组织与项目可由 $ADO_DEFAULT_ORG 和 $ADO_DEFAULT_PROJECT 提供,当无法从 git remote 解析或不在 git 仓库中时作为回退,如 org="${org:-$ADO_DEFAULT_ORG}",并通过 --org "https://dev.azure.com/${org}" 和 --project "$project" 传给 az 命令。
URL 解析与浏览:支持三种远程 URL 格式(dev.azure.com HTTPS、visualstudio.com、SSH git@ssh.dev.azure.com:v3/...),解析出 org、project、repo;构造 Web URL 时项目名空格需编码为 %20,base_url=https://dev.azure.com/{org}/{project}/_git/{repo},PR 链接为 {base_url}/pullrequest/{pr_id};macOS 使用 open "$url" 打开。
使用方式:各操作给出具体 az 命令与 JMESPath 查询示例,PR 命令常带 --output table 与 --query;完成 PR 通过 az repos pr update --id <pr-id> --status completed --bypass-policy true,完成后状态更新为异步,需用 az repos pr show --id <pr-id> 确认 status: completed 与 mergeStatus: succeeded。PR 评论与部分管理操作走 REST API,用 curl 配合 PAT 与 api-version(如 7.0、7.1、7.1-preview.1),并用 jq 过滤输出。
限制:完成策略绕过的语义、各 api-version 的可用范围、权限与配额、平台差异等未在资料中说明;缺失事实暂未提供。