API Contract Review

Controleert Spring/REST controllers op HTTP-werkwoorden, versiebeheer, statuscodes en compatibiliteit

Door decebals · decebals/claude-code-java

Getest · Werkt ★ 8.8/10

API Contract Review — Controleert Spring/REST controllers op HTTP-werkwoorden, versiebeheer, statuscodes en compatibiliteit

Wat het doet

Controleert REST API controllers (Java/Spring-gericht) aan de hand van een 6-punten checklist die HTTP-werkwoordsemantiek, URL-versiebeheer, DTO-vs-entity lekken, correctheid van statuscodes, foutresponsformaat en achterwaartse compatibiliteit omvat. Activeert wanneer de gebruiker vraagt om een API te beoordelen, REST-endpoints te controleren, of vóór het vrijgeven van API-wijzigingen. Werkt samen met spring-boot-patterns, die controllers schrijft terwijl deze ze controleert.

Testrapport

SKILL.md + README opgehaald via GitHub API/raw; beide gerefereerde bestanden retourneren HTTP 200, frontmatter heeft name+description, geen externe scripts, geen beveiligingsrisico's (alleen goedaardige inline grep tips). Een Spring UserController geschreven met ingeplante problemen (GET-gebaseerde delete, POST voor idempotente update, geen /v1/, entity return, null-on-miss, Map status:200 body) en twee reviews geproduceerd. Baseline ving de GET-delete, null-return, entity leak, en ontbrekende paginering op, maar MISTE versiebeheer, het verkeerde PUT/POST werkwoord, het 200-met-status-body anti-patroon, en ontbrekende @Valid; de skill review ving al deze op en organiseerde bevindingen per de 6 categorieën terwijl off-topic hygiëne ruis (constructor injectie) werd weggelaten. Trigger beoordeling: laadt op "review the REST endpoints in UserController", "check my API before I release", "are my HTTP verbs/status codes right"; laadt correct NIET op "write a new REST controller for orders" (creatie, geen audit) of "review my DB schema for indexing" (geen REST) — 5/5.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/decebals/claude-code-java.git /tmp/api-contract-review-src
mkdir -p ~/.claude/skills
cp -R /tmp/api-contract-review-src/.claude/skills/api-contract-review ~/.claude/skills/api-contract-review
# Self-contained: SKILL.md + README.md only, no external scripts or deps.
# Java/Spring-oriented (Spring annotations, JPA entities), but the HTTP/REST
# checklist applies to any REST API. No API keys, no tools to install.

Commando's en voorbeeldprompts

/api-contract-reviewControleert Spring/REST controllers op HTTP-werkwoorden, versiebeheer, statuscodes en compatibiliteit

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Review this API for backward compatibility issues
Check these endpoints for REST semantics violations
Review the API contract before releasing v2

Volledig rapport (Engels) →