Doncheli API Contract

Wymusza kompletny szablon kontraktu API: uwierzytelnianie, limity szybkości, ponowne próby, wyłącznik obwodu, idempotencja, wersjonowanie.

Autor: doncheli · doncheli/don-cheli-sdd

Testowano · Działa ★ 9.2/10

Doncheli API Contract — Wymusza kompletny szablon kontraktu API: uwierzytelnianie, limity szybkości, ponowne próby, wyłącznik obwodu, idempotencja, wersjonowanie.

Co robi ten skill

Tworzy ustrukturyzowany dokument kontraktu API dla każdego punktu końcowego/operacji, obejmujący schematy żądań/odpowiedzi, katalogi błędów, zakresy uwierzytelniania, limity szybkości, politykę ponownych prób i wyłącznika obwodu oraz wymagania dotyczące idempotencji, a następnie politykę zmian powodujących niezgodność dla całej powierzchni. Uruchamia się na żądania projektowania API/kontraktu/punktu końcowego/webhook/REST/GraphQL/OpenAPI; wyraźnie odsyła do siostrzanych umiejętności w przypadku żądań tylko przeglądu lub tylko implementacji.

Raport z testu

Uruchomiono rzeczywiste zadanie kontraktu webhook: bazowa wersja obejmowała ładunek i niejasną notatkę o ponownych próbach; lista kontrolna umiejętności wymusiła jawny klucz idempotencji/TTL, 5-przypadkowy katalog błędów i projekt wyłącznika obwodu dla burz ponownych prób, których bazowa wersja nigdy nie brała pod uwagę.

Testowano: 2026-07-14 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/doncheli/don-cheli-sdd
cd don-cheli-sdd
mkdir -p ~/.claude/skills
cp -r .agent/skills/doncheli-api-contract ~/.claude/skills/doncheli-api-contract

Komendy i przykładowe prompty

  • /doncheli-api-contractWymusza kompletny szablon kontraktu API: uwierzytelnianie, limity szybkości, ponowne próby, wyłącznik obwodu, idempotencja, wersjonowanie.

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • Design the API contract for our new Stripe webhook integration.
  • Define endpoints, auth, and error handling before we start building.
  • Help me spec out rate limiting and retries for this REST API.