Doncheli API Contract
Impone un template di contratto API completo: auth, rate limit, retry, circuit breaker, idempotenza, versioning.
Promosso
Cosa fa
Produce un documento di contratto API strutturato per endpoint/operazione che copre schemi di richiesta/risposta, cataloghi di errori, ambiti di autenticazione, rate limiting, policy di retry e circuit-breaker e requisiti di idempotenza, quindi una policy di breaking-change per l'intera superficie. Si attiva su richieste di design API/contratto/endpoint/webhook/REST/GraphQL/OpenAPI; si rimanda esplicitamente a skill correlate per richieste di sola revisione o sola implementazione.
Rapporto di test
Ho eseguito un vero compito di contratto webhook: la baseline copriva il payload e una nota vaga di retry; la checklist della skill ha imposto una chiave/TTL di idempotenza esplicita, un catalogo errori a 5 casi e un design di circuit-breaker per tempeste di retry che la baseline non aveva mai considerato.
Testato il: 2026-07-14 · Claude Code 2.x (agent harness)
Installazione
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
Comandi e prompt di esempio
/doncheli-api-contractImpone un template di contratto API completo: auth, rate limit, retry, circuit breaker, idempotenza, versioning.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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.