| name | azsdk-common-pipeline-troubleshooting |
| description | Diagnose and resolve failures in Azure SDK CI and generation pipelines. **UTILITY SKILL**. USE FOR: \"pipeline failed\", \"build failure\", \"CI check failing\", \"SDK generation error\", \"reproduce pipeline locally\", \"debug SDK pipeline\". DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing. INVOKES: azure-sdk-mcp:azsdk_analyze_pipeline, azure-sdk-mcp:azsdk_verify_setup, azure-sdk-mcp:azsdk_package_build_code, azure-sdk-mcp:azsdk_package_run_check, azure-sdk-mcp:azsdk_package_pack. Use when this capability is needed. |
Pipeline Troubleshooting
This skill diagnoses and resolves failures in Azure SDK CI and generation pipelines by analyzing pipeline runs, reproducing issues locally, and applying targeted fixes for build, validation, or TypeSpec problems before verifying the rerun.
Triggers
USE FOR: pipeline failed, build failure, CI check failing, SDK generation error, reproduce pipeline locally, debug SDK pipeline
WHEN: "pipeline failed", "build failure", "CI check failing", "SDK generation error", "reproduce pipeline locally", "debug SDK pipeline"
DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing
Rules
- Requires the
azure-sdk-mcp server; without MCP, inspect logs in the Azure DevOps UI.
- Start with the pipeline build ID and run pipeline analysis before attempting local reproduction.
- Verify the local environment before running build or check commands to reproduce the failure.
MCP Tools
| Tool | Purpose |
|---|
azure-sdk-mcp:azsdk_analyze_pipeline | Analyze pipeline failure |
azure-sdk-mcp:azsdk_verify_setup | Verify local environment |
azure-sdk-mcp:azsdk_package_build_code | Reproduce build locally |
azure-sdk-mcp:azsdk_package_run_check | Run validation checks |
azure-sdk-mcp:azsdk_package_pack | Create SDK packages |
Prerequisites: azure-sdk-mcp server required. Without MCP, view pipeline logs in Azure DevOps UI.
Steps
- Identify — Get build ID, run
azure-sdk-mcp:azsdk_analyze_pipeline. Categorize failure.
- Analyze — See failure patterns for common causes.
- Reproduce — Verify setup, then run
azure-sdk-mcp:azsdk_package_build_code or azure-sdk-mcp:azsdk_package_run_check.
- Fix — Apply fixes for code or TypeSpec issues.
- Verify — Confirm fix locally, push, monitor re-run.
Examples
- "My pipeline build 12345 failed, help debug it"
- "Reproduce CI failure locally"
Troubleshooting
If azure-sdk-mcp:azsdk_analyze_pipeline returns no data, verify build ID and MCP. Without MCP, check pipeline logs in Azure DevOps UI.
Source: Azure/azure-sdk-for-cpp — distributed by TomeVault.
