API Gateway
Referencje AWS API Gateway: przepisy CLI REST/HTTP, CORS, uwierzytelnianie JWT, rozwiązywanie problemów 502/504
Działa po konfiguracji
Co robi ten skill
Umiejętność referencyjna dla Amazon API Gateway, która dostarcza przepisy CLI dla interfejsów API REST i HTTP, szablon SAM, kształt handlera proxy Lambda, konfigurację CORS dla obu typów API, konfigurację autoryzatora JWT oraz sekcję rozwiązywania problemów obejmującą błędy 403, 502, 504 i CORS. Uruchamia się, gdy pytasz o tworzenie API Gateway API, łączenie integracji Lambda lub usług AWS, konfigurowanie autoryzatorów, zarządzanie etapami i wdrożeniami, dodawanie planów użycia lub ograniczania przepustowości, lub debugowanie kodów błędów API Gateway. Część wtyczki aws-agent-skills, która zawiera 18 umiejętności usług AWS instalowanych razem.
Raport z testu
Zlokalizowano skills/api-gateway/SKILL.md za pośrednictwem GitHub tree API (343 linie, frontmatter zawiera name + description + last_updated 2026-01-07); wyrywkowo pobrano integration-patterns.md (HTTP 200) i .claude-plugin/marketplace.json (HTTP 200), który wymienia ./skills/api-gateway, więc ścieżka instalacji jest możliwa do wyprowadzenia i żadne ścieżki maszynowe nie są twardo zakodowane; grep dla curl|sh, base64 -d, eval i tekstu iniekcji nic nie znalazł. Frazy wyzwalające ocenione: POWINIEN — "Skonfiguruj HTTP API przed moją Lambdą z autoryzatorem Cognito JWT" (załadowanie), "Mój punkt końcowy API Gateway zwraca 502 Bad Gateway, pomóż mi debugować" (załadowanie), "Dodaj plan użycia i ograniczanie kluczem API do naszego etapu REST API" (załadowanie); NIE POWINIEN — "Dodaj middleware ograniczające szybkość do mojej aplikacji Express działającej na ECS" (pominięcie), "Zaprojektuj schemat nazewnictwa zasobów REST API dla naszej wewnętrznej usługi" (pominięcie); 5/5 poprawnie, kotwica "AWS API Gateway" zapobiega nadmiernemu wyzwalaniu ogólnych fraz, takich jak "rozwiązywanie problemów z API". Dla wyjścia napisałem oba artefakty (apigw-baseline.md vs skillrun.md w scratchpadzie) dla jednego zadania: HTTP API POST /orders wspierane przez Lambda, uwierzytelnianie Cognito JWT, CORS dla jednego źródła. Moja wersja bazowa obejmowała wszystkie 6 kroków potrzebnych do działającego punktu końcowego; ścisłe przestrzeganie treści SKILL.md obejmowało około 3 — treść pokazuje tylko skrót `create-api --target` do szybkiego tworzenia i nigdy nie podaje przykładu `create-route` ani `create-integration` (`create-route` pojawia się tylko jako jednoliniowy wiersz w tabeli CLI), nigdy nie wspomina `--payload-format-version 2.0`, i `aws lambda add-permission` nie pojawia się nigdzie w SKILL.md ani integration-patterns.md, więc dosłowne przestrzeganie wdraża API, które zwraca 500. Umiejętność dodała dwie rzeczy, które moja wersja bazowa pominęła: dekodowanie treści isBase64Encoded w handlerze i notatki o 502 "missing statusCode" / 504 29s-vs-30s timeout. Wynik netto 5/10. Dokumentacja obniżona do 3: integration-patterns.md nigdy nie jest linkowany z SKILL.md, więc progresywne ujawnianie jest martwe, przykład instalacji Codex w README wskazuje na nieistniejącą umiejętność `rlhf` w tym repozytorium, a "deep expertise / real-world patterns, edge cases" przesadza z tym, co jest kompetentną, ale niekompletną ściągawką; twierdzenia o "18 usługach" i cotygodniowej weryfikacji dokumentacji sprawdziły się w drzewie i .github/workflows/weekly-aws-doc-check.yml.
Testowano: 2026-07-21 · Claude Code 2.x (agent harness)
Instalacja
git clone --depth 1 https://github.com/itsmostafa/aws-agent-skills.git /tmp/api-gateway-src mkdir -p ~/.claude/skills cp -R /tmp/api-gateway-src/skills/api-gateway ~/.claude/skills/api-gateway # Plugin instead (installs all 18 AWS skills): /plugin marketplace add itsmostafa/aws-agent-skills # then /plugin install aws-agent-skills # The skill body is pure reference text; the AWS CLI is only needed if you run the commands it shows.
Komendy i przykładowe prompty
/api-gatewayReferencje AWS API Gateway: przepisy CLI REST/HTTP, CORS, uwierzytelnianie JWT, rozwiązywanie problemów 502/504
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
Set up rate limiting on this API GatewayConfigure a Lambda integration for this endpointTroubleshoot this API Gateway 403 error