API Tester

Genera pruebas de API a partir de código OpenAPI + ruta real, nunca adivina códigos de estado.

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

Probado · Funciona ★ 9.2/10

API Tester — Genera pruebas de API a partir de código OpenAPI + ruta real, nunca adivina códigos de estado.

Qué hace

Genera y ejecuta pruebas de API utilizando únicamente evidencia de contrato verificable — la especificación OpenAPI, la implementación de la ruta/controlador, los DTOs y las pruebas existentes — y registra las divergencias entre la especificación y el código en lugar de congelar suposiciones en aserciones. Se activa cuando se solicitan pruebas de integración, pruebas de contrato, casos de regresión para un endpoint o verificaciones de compatibilidad de API. Separa 'generate tests' de 'execute requests' y rechaza solicitudes de escritura contra entornos no confirmados.

Informe de la prueba

Se ensambló un proyecto Express real con una discrepancia intencional entre la especificación y el código: openapi.yaml prometía POST /users → 201, 400 y 401, pero app.js en realidad devolvía 200 y 422, y 401 era inalcanzable (sin middleware de autenticación o esquema de seguridad). El conjunto de línea base, generado a partir de la especificación de la forma habitual, arrojó 2 pasados / 3 fallidos en `node --test`: se esperaba 201 — se obtuvo 200, se esperaba 400 — se obtuvo 422, se esperaba 401 — se obtuvo 200. El conjunto de SKILL.md arrojó 4 pasados / 0 fallidos: la skill lee la implementación como la fuente de verdad, afirma solo rutas verdaderamente alcanzables y reporta las tres discrepancias en lugar de congelarlas como pruebas que fallan falsamente; no generó una prueba para 401 en absoluto, siguiendo la regla 'do not assume every endpoint must return 400/401/403/404'. Etapa 0 limpia: un único SKILL.md sin scripts, red ni exfiltración. La skill está completamente en chino — los informes y títulos de las pruebas están en chino, lo que es una fricción para un equipo de habla inglesa; no hay automatización en ella, es una lista de verificación disciplinaria.

Probado el: 2026-07-16 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /api-testerGenera pruebas de API a partir de código OpenAPI + ruta real, nunca adivina códigos de estado.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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