community-automations/api-designer

DevOps e codice

PublicSubagent Claude

Designer di API

Progettare un'API a mano significa ore in YAML a tenere coerenti path, schemi ed esempi prima che esista una sola riga di codice server. Questo designer prepara l'intera spec partendo da una semplice descrizione.

sonnet4 giorniOpenAIOpenAPI 3.1StoplightRedocly
ClaudeClaude
ROI for
README.md

Perché questo subagent

Progettare un'API a mano significa ore in YAML a tenere coerenti path, schemi ed esempi prima che esista una sola riga di codice server. Questo designer prepara l'intera spec partendo da una semplice descrizione.

Descrivi il caso d'uso e ti restituisce una spec OpenAPI 3.1 validata con path, schemi, auth e payload di esempio, pronta da dare in pasto alla codegen. Tu revisioni e fai il merge, invece di battere parentesi.

Come gira

    • Read

      Used at step 01 to kick off the pipeline.

    • Write

      Used at step 01 to kick off the pipeline.

    • WebFetch

      Used at step 01 to kick off the pipeline.

    • WebSearch

      Used at step 01 to kick off the pipeline.

Esempio di output

json
// Sample output
// (generated when the pipeline finishes)

Turn the described use case into a valid OpenAPI 3.1 document with named schemas, every CRUD path, request and response examples, auth, and standard error responses.

Unlock the rest

The full agent definition, install snippet, and starter task are gated for community members.

Members get the full `.md` agent file, the npm / pnpm install one-liners, a starter prompt that we've tuned against real runs, and the open-source repo when this automation ships there. One email, magic link, done.