azure-devops-rest-api

Guide for working with Azure DevOps REST APIs and OpenAPI specifications. Use this skill when implementing new Azure DevOps API integrations, exploring API capabilities, understanding request/response formats, or referencing the official OpenAPI specifications from the vsts-rest-api-specs repository.

1. Zainstaluj umiejętność w swoim środowisku Claude/Copilot, wskazując repozytorium mcp-server-azure-devops jako źródło. Upewnij się, że masz dostęp do oficjalnych specyfikacji OpenAPI z repozytorium vsts-rest-api-specs firmy Microsoft.

2. Gdy potrzebujesz zintegrować nowy endpoint Azure DevOps, opisz cel integracji — na przykład "Chcę pobrać listę projektów" lub "Potrzebuję stworzyć nowy element pracy". Umiejętność wskaże Ci odpowiedni obszar API (core, git, wit, build, pipelines itp.) i strukturę żądania.

3. Skonsultuj się z umiejętnością w sprawie formatów żądań i odpowiedzi dla wybranego endpointu. Podaj szczegóły takie jak metoda HTTP (GET, POST, PATCH), wymagane parametry i nagłówki autoryzacji.

4. Użyj umiejętności do eksploracji dostępnych pól i opcji w odpowiedziach API. Na przykład, jeśli pracujesz z elementami pracy, umiejętność pomoże Ci zrozumieć strukturę danych zwracaną przez endpoint wit.

5. Gdy implementujesz złożoną integrację obejmującą wiele obszarów (np. pobieranie potoku, tworzenie kompilacji, zarządzanie uprawnieniami), poproś umiejętność o mapę przepływu między endpointami — na przykład między build, pipelines i security.

6. Odwołuj się do umiejętności jako do referencji podczas debugowania błędów API — podaj kod błędu lub komunikat, a umiejętność pomoże Ci zidentyfikować brakujące parametry lub nieprawidłowe formaty danych.