skilly. Buy ad slot
All skills
Community / AGENT SKILL

backend-create-api

Vitammiin/agent-vorcl-flow
0 installs 2 GitHub stars
0

Генерация API-эндпоинта (роль backend). Use when нужно создать НОВЫЙ REST-эндпоинт/роут с нуля — слои, валидация, Swagger; для правки существующего кода бери $backend-refactor/$backend-optimize.

BEFORE YOU INSTALL

Understand the trade-offs.

SECURITY REVIEW

Not yet assessed

Review the original instructions and requested permissions before installing.

No security review is available for this catalog entry yet.

SKILL QUALITY

Not yet assessed

How clearly the skill guides your agent, how complete its workflow is, and how you can check the outcome.

No quality assessment is available for this catalog entry yet.

The full skill.

Original instructions from the publisher’s SKILL.md

# Задача: создание API-эндпоинта

Сгенерируй REST-эндпоинт по спецификации, которую дал пользователь.

Размести код по модульной архитектуре из `$backend-architecture`: модуль `src/modules/<module>/` (auth, users, ai, billing, notifications или новый), слои `schemas → dto/types → repository → service → controller → routes`, экспорт через `index.ts`. Дай типы (вывод из zod-схем), валидацию входа, обработку ошибок и тесты эндпоинта. Роут сразу **полностью** покрой OpenAPI/Swagger по `$swagger-coverage` (для дефолт-стека плагина — Fastify + zod): полная `schema` (`summary`/`description`/`tags`/`operationId`, `response` по всем статусам, включая ошибки через общий `ErrorSchema`, `security` для защищённых) — те же zod-схемы дают и валидацию, и OpenAPI.

Два обязательных требования к результату:

1. **Материализация.** Код сохраняй файлами в рабочем каталоге проекта по его конвенциям (реальные пути, а не сниппеты в ответе); в конце перечисли все созданные/изменённые пути.
2. **Валидация перед выдачей.** Типизация (`tsc --noEmit`) и линт без ошибок; тесты эндпоинта прогнаны и зелёные — либо живая curl-проверка на поднятом сервере с ожидаемыми ответами (успех + ошибка валидации). Только зелёный результат = готово; «должно работать» не принимается.

Если спецификация не указана — спроси метод, путь и контракт (вход/выход) одной репликой. Если проект не на дефолт-стеке (не Fastify/Node) — скажи честно и адаптируй слои под фактический фреймворк, не навязывая чужие конвенции.

Опирайся на `$nodejs`, `$typescript`, `$backend-architecture`, `$swagger-coverage`.