用途:以 Azure CLI(az devops)为主轴操作 Azure DevOps,为专有命令不支持的操作提供 az devops invoke(REST API 包装)补充。
主要能力:工作项(az boards work-item / az boards query)支持创建、更新、查询(WIQL)与关联;拉取请求(az repos pr)支持创建、评审、投票、合并;仓库(az repos / az repos ref)支持仓库与分支管理;流水线(az pipelines / az pipelines build)支持运行、监控与变量管理。无专用命令的操作需用 az devops invoke,例如 PR 评论与线程、构建时间线、测试结果、附件、Git 差异、通知等,具体参考 references/rest-api.md。
必要用法:Windows 日文环境下 Azure CLI(MSI 版)以孤立模式启动内置 Python,PYTHONUTF8=1 等环境变量无效,输出恒为 cp932,所有 az 命令末尾需追加 2>&1 | iconv -f cp932 -t utf-8,例如 az boards work-item show --id 123 --output table 2>&1 | iconv -f cp932 -t utf-8。可先用 az account show 检查登录,az extension show --name azure-devops 检查扩展,并用 az devops configure --defaults organization=... 与 project=... 设置默认值。az devops invoke 的 --resource 必须填 CLI 内部 resource 名(通常 camelCase),如 git/pullRequestThreads、build/Timeline,而非 REST API 路径名,否则会报 --resource and --api-version combination is not correct;可用 az devops invoke --query 列出可用 area/resource。输出可用 --output table、--output json 与 --query(JMESPath)过滤。可选使用已配置的 Azure DevOps MCP Server(@azure-devops/mcp),功能与 CLI 等同,结构化数据获取可能更高效。
限制:未提供本技能所在平台的具体安装方式、版本兼容范围与收费信息;未配置 Azure DevOps MCP Server 时无法使用 MCP 工具;az devops invoke 的可用 area/resource 需按实际环境查询确认。