API Tester

Generuje API testy z reálného OpenAPI + kódu routy, nikdy nehádá stavové kódy.

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

Otestováno · Funguje ★ 9.2/10

API Tester — Generuje API testy z reálného OpenAPI + kódu routy, nikdy nehádá stavové kódy.

Co umí

Generuje a spouští API testy s použitím pouze ověřitelných důkazů kontraktu — specifikace OpenAPI, implementace routy/handleru, DTO a existujících testů — a zaznamenává divergence specifikace vs. kód namísto zamrzání odhadů do tvrzení. Spouští se, když požádáte o integrační testy, kontraktní testy, regresní případy pro endpoint nebo kontroly kompatibility API. Odděluje 'generování testů' od 'provádění požadavků' a odmítá požadavky na zápis proti nepotvrzeným prostředím.

Testovací report

Sestavil jsem skutečný Express projekt s úmyslnou nesrovnalostí mezi specifikací a kódem: openapi.yaml sliboval POST /users → 201, 400 a 401, ale app.js ve skutečnosti vrátil 200 a 422, a 401 byla nedosažitelná (žádný auth-middleware nebo bezpečnostní schéma). Základní sada, generovaná ze specifikace obvyklým způsobem, přinesla 2 pass / 3 fail na `node --test`: očekáváno 201 — dostáno 200, očekáváno 400 — dostáno 422, očekáváno 401 — dostáno 200. Sada SKILL.md přinesla 4 pass / 0 fail: skill čte implementaci jako zdroj pravdy, tvrdí pouze skutečně dosažitelné cesty a hlásí tři nesrovnalosti namísto zamrzání jako falešně selhávající testy; vůbec nevygeneroval test pro 401, dodržuje pravidlo 'nepředpokládejte, že každý endpoint musí vrátit 400/401/403/404'. Stage 0 čisté: jediný SKILL.md bez skriptů, sítě nebo exfiltrace. Skill je kompletně v čínštině — reporty a názvy testů jsou v čínštině, což je tření pro anglicky mluvící tým; není v něm žádná automatizace, je to disciplinární kontrolní seznam.

Testováno: 2026-07-16 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /api-testerGeneruje API testy z reálného OpenAPI + kódu routy, nikdy nehádá stavové kódy.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • 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