SkillProof tested Claude skills

API Tester

Genera test API da codice OpenAPI + route reale, non indovina mai i codici di stato

di laolaoshiren · laolaoshiren/claude-code-skills-zh

Promosso ★ 9.2/10

API Tester — Genera test API da codice OpenAPI + route reale, non indovina mai i codici di stato

Cosa fa

Genera ed esegue test API utilizzando solo prove contrattuali verificabili — la specifica OpenAPI, l'implementazione di route/handler, i DTO e i test esistenti — e registra le divergenze tra spec e codice invece di congelare le ipotesi in asserzioni. Si attiva quando si richiedono test di integrazione, test di contratto, casi di regressione per un endpoint o controlli di compatibilità API. Separa 'genera test' da 'esegui richieste' e rifiuta richieste di scrittura contro ambienti non confermati.

Rapporto di test

Assemblato un progetto Express reale con una discrepanza intenzionale tra spec e codice: openapi.yaml prometteva POST /users → 201, 400 e 401, ma app.js restituiva effettivamente 200 e 422, e 401 era irraggiungibile (nessun auth-middleware o schema di sicurezza). Il set baseline, generato dalla spec nel modo usuale, ha prodotto 2 pass / 3 fail su `node --test`: atteso 201 — ottenuto 200, atteso 400 — ottenuto 422, atteso 401 — ottenuto 200. Il set SKILL.md ha prodotto 4 pass / 0 fail: la skill legge l'implementazione come fonte di verità, asserisce solo percorsi veramente raggiungibili e riporta le tre discrepanze invece di congelarle come test falsamente falliti; non ha generato un test per 401 affatto, seguendo la regola 'non assumere che ogni endpoint debba restituire 400/401/403/404'. Fase 0 pulita: un singolo SKILL.md senza script, rete o esfiltrazione. La skill è interamente in cinese — report e titoli dei test sono in cinese, il che è un attrito per un team di lingua inglese; non c'è automazione in essa, è una checklist disciplinare.

Testato il: 2026-07-16 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/laolaoshiren/claude-code-skills-zh.git
mkdir -p ~/.claude/skills
cp -r claude-code-skills-zh/skills/api-tester ~/.claude/skills/api-tester

Comandi e prompt di esempio

  • /api-testerGenera test API da codice OpenAPI + route reale, non indovina mai i codici di stato

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Generate integration tests for this endpoint from the actual route code
  • Check if my OpenAPI spec matches what this handler actually returns
  • Write contract tests but flag any spec versus implementation mismatches

Rapporto completo →