azure-devops-rest-api
Przewodnik do integracji API Azure DevOps — dokumentacja OpenAPI i specyfikacje REST
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność ułatwiająca pracę z REST API Azure DevOps na podstawie oficjalnych specyfikacji OpenAPI z repozytorium vsts-rest-api-specs. Użyj jej podczas implementacji nowych integracji API, eksploracji możliwości usługi, zrozumienia formatów żądań i odpowiedzi oraz odwoływania się do dokumentacji. Obejmuje główne obszary: zarządzanie projektami, repozytoria Git, potoki budowania, śledzenie elementów pracy, artefakty, bezpieczeństwo i rozszerzenia.
Jak używać
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.
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.
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.
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.
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.
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.