API Tester

Génère des tests d'API à partir de code OpenAPI + route réel, ne devine jamais les codes de statut

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

Testé · Fonctionne ★ 9.2/10

API Tester — Génère des tests d'API à partir de code OpenAPI + route réel, ne devine jamais les codes de statut

Ce que fait

Génère et exécute des tests d'API en utilisant uniquement des preuves de contrat vérifiables — la spécification OpenAPI, l'implémentation de route/gestionnaire, les DTOs et les tests existants — et enregistre les divergences spec-vs-code au lieu de figer les suppositions en assertions. Sépare 'générer des tests' de 'exécuter des requêtes' et refuse les requêtes d'écriture contre des environnements non confirmés.

Rapport de test

Assemblé un projet Express réel avec une divergence intentionnelle entre la spécification et le code : openapi.yaml promettait POST /users → 201, 400 et 401, mais app.js renvoyait en fait 200 et 422, et 401 était inaccessible (pas de middleware d'authentification ou de schéma de sécurité). L'ensemble de base, généré à partir de la spécification de la manière habituelle, a donné 2 succès / 3 échecs sur `node --test` : attendu 201 — obtenu 200, attendu 400 — obtenu 422, attendu 401 — obtenu 200. L'ensemble SKILL.md a donné 4 succès / 0 échec : la compétence lit l'implémentation comme source de vérité, n'affirme que les chemins réellement atteignables, et rapporte les trois divergences au lieu de les figer comme des tests faussement échoués ; elle n'a pas généré de test pour 401 du tout, suivant la règle 'ne pas supposer que chaque endpoint doit renvoyer 400/401/403/404'. Stage 0 propre : un seul SKILL.md sans scripts, réseau ou exfiltration. La compétence est entièrement en chinois — les rapports et les titres de test sont en chinois, ce qui est une friction pour une équipe anglophone ; il n'y a pas d'automatisation, c'est une checklist disciplinaire.

Testé le: 2026-07-16 · Claude Code 2.x (agent harness)

Installation

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

Commandes et exemples de prompts

/api-testerGénère des tests d'API à partir de code OpenAPI + route réel, ne devine jamais les codes de statut

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →