Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

bec-api-design

/bec-api-design

Projektuje lub przegląda semantykę API usług: żądania, odpowiedzi, stronicowanie, idempotencję i kontrakty błędów.

Repozytorium
backend-craft ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
10
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: examples/engineering/server.go, examples/engineering/server_test.go

Co robi i kiedy

Projektuje lub przegląda semantykę API usług: żądania, odpowiedzi, stronicowanie, idempotencję i kontrakty błędów.

Oryginalny opis (EN)

Use when Service API request/response semantics, compatibility, pagination, idempotency, error contracts or server-side API validation need design or review.

Jak działa

  1. Apply the workflow
  2. Task boundary
  3. Engineering practices
Sekcje z nagłówków SKILL.md, w oryginale · 20 linii, 153 słów
Podgląd SKILL.md
---
name: bec-api-design
description: "Use when Service API request/response semantics, compatibility, pagination, idempotency, error contracts or server-side API validation need design or review."
---

# Backend API contracts

Start from actual operations, clients, trust boundaries and deployed contract versions; distinguish missing business decisions from endpoint mechanics.

## Apply the workflow

1. Locate the actual project, task boundary and existing contracts; load only the language and domain material needed now.
2. Apply the [specialist checks](references/practice.md), establishing the input evidence before selecting the smallest change.
3. Verify affected behavior with existing repository tools. Explicitly report missing tools, environments or execution; a plan is not a passing result.
4. Deliver scope, specialist decisions, actual verification and remaining risk. A review-only task stays read-only.

## Task boundary

Frontend data-fetching integration and product requirement handoff are separate; API shape does not replace authorization or database consistency.

## Engineering practices

Read the [local engineering decisions](references/engineering-practices.md) for this task and follow their links to relevant shared principles. Apply levels and exceptions against actual project contracts; product frontend/backend labels do not constrain language or role.
Pliki w paczce (10)
  • SKILL.md 1 KB
  • examples/engineering/README.md 2 KB
  • examples/engineering/go.mod 1 KB
  • examples/engineering/server.go 2 KB
  • examples/engineering/server_test.go 3 KB
  • references/engineering-practices.md 3 KB
  • references/practice.md 2 KB
  • references/common/engineering-practices.md 12 KB
  • references/common/engineering-practices.rules.json 2 KB
  • references/common/engineering-practices.sources.json 16 KB

Wersje

W bazie nie ma innych skilli o nazwie bec-api-design.

Migawka bazy z 13.11.2026 · wersja paczki 67c6c891396a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100rest-api-design
    Projektuje lub sprawdza kontrakty HTTP API: zasoby, operacje, statusy i błędy, stronicowanie, zgodność oraz wersjonowanie.
  • 100api-design
    Projektuje lub przegląda API HTTP: zasoby, OpenAPI, błędy, stronicowanie, wersje, idempotencję i uwierzytelnianie.
  • 90bec-architecture-design
    Projektuje lub przegląda granice modułów backendu, własność danych, kierunki zależności i kompromisy architektoniczne.
  • 90bec-database-design
    Projektuje lub przegląda schemat bazy, zapytania, indeksy i migracje, z ryzykiem wdrożenia i wycofania.
  • 100api-contract
    Projektuje lub zmienia API HTTP tak, by nie zepsuć niewidocznych klientów: wersje, stronicowanie, idempotencję i kody błędów.
  • 100api-design
    Projektuje i przegląda kontrakty HTTP i OpenAPI: nazwy zasobów, kody, błędy RFC 9457, stronicowanie, idempotencję i limity.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.