azdo-build-investigator
Installation
SKILL.md
AZDO Build Investigator
Given a build URL or GitHub PR URL, fetch run details, find failed jobs/tasks, download logs and .binlog artifacts, and produce a summarized root-cause error trail.
Prerequisites
The tools below are required as follows: az is always required; gh is required only for GitHub PR URLs; binlogtool is required only for .binlog analysis. If any required tool is missing for the current task, stop immediately, show the relevant setup link, and do NOT install on the user's behalf.
| Tool | Check | Install / Docs |
|---|---|---|
gh (GitHub CLI) |
gh --version |
https://docs.github.com/github-cli/github-cli/quickstart |
az (Azure CLI + DevOps ext) |
az --version |
Install: https://learn.microsoft.com/cli/azure/install-azure-cli — Extension: az extension add --name azure-devops — Docs: https://learn.microsoft.com/cli/azure/devops — Then: az login and az devops configure --defaults organization=https://dev.azure.com/ORGNAME project=PROJECTNAME |
binlogtool (.NET global tool) |
dotnet tool list -g |
dotnet tool install -g binlogtool — https://www.nuget.org/packages/binlogtool |
Workflow
Follow in order. Stop early if root cause is found.