Pipeline Analysis

This skill analyzes Azure SDK CI/CD pipeline failures and provides a structured diagnosis including root cause, affected files, and concrete instructions for how to fix each issue. It does NOT apply fixes - it tells you exactly what's wrong and how to resolve it.

Rules

• Load this skill before running azsdk_analyze_pipeline — the tool returns raw failure data that this skill interprets and formats per output format.
• Requires the azure-sdk-mcp server; without it, inspect logs in the Azure DevOps UI.
• Analysis-only: never edit files or apply fixes — use azsdk-common-pipeline-fixer for changes.
• Run azsdk_analyze_pipeline first, then categorize each failure and cite specific files/lines.
• For infrastructure failures (network timeouts, agent crashes, throttling), recommend retry, not code changes.

MCP Tools

Steps

1. Identify - Get the build ID, pipeline URL, or PR link (use the PR link when triggered from a PR comment).
2. Analyze - Run azsdk_analyze_pipeline. It returns failed_pipeline_tasks (log errors from failed steps) and failed_pipeline_tests, a lightweight index of failed tests grouped by artifact file. Each entry has artifact_file_path, platform, and failed_test_titles — titles only, no error text, to keep the response small.
3. Fetch failure details - Fetch failure details lazily so you don't overload context: call azsdk_get_failed_test_run_data with the parameter failedTestRunsPath set to artifact_file_path once per file to get every failure in it. Or call azsdk_get_failed_test_case_data with failedTestRunsPath set to artifact_file_path and testCaseTitle set to one exact title from failed_test_titles. Prefer the per-file call when triaging a whole file's failures.
4. Categorize each failure: test, build/compilation, validation/lint, or infrastructure.
5. Diagnose - Give each failure's root cause and affected file(s)/line(s), and note if several share one root cause. See failure patterns.
6. Report - Use the output format: root cause, affected files, per-failure fix + verify command, and fixable vs infrastructure. Recommend azsdk-common-pipeline-fixer to apply fixes.

Examples

• "My pipeline build 6447834 failed, what went wrong?"
• PR comment: @copilot Analyze the failed pipeline on this PR
• "Why is my CI red? Build ID is 6455939"

Troubleshooting

• If azsdk_analyze_pipeline returns no data, verify the build ID is correct and the run has completed.
• If failed_pipeline_tests is empty, rely on failed_pipeline_tasks log analysis (test-artifact upload may not be configured).
• For a private/internal pipeline, the user may need to az login. See failure patterns.