migrating-apis

Skill do migracji API między wersjami, platformami lub frameworkami z minimalnym czasem przestoju. Automatycznie inventaryzuje istniejące endpointy, generuje mapowanie do nowych wersji, tworzy adaptery transformujące żądania i odpowiedzi, oraz wdraża routing ruchu dla stopniowego przejścia. Obsługuje wzorzec strangler fig, równoległy uruchomienie i traffic shadowing. Wymaga dostępu do kodu źródłowego API, specyfikacji OpenAPI i możliwości routowania ruchu przez reverse proxy lub API gateway.

1. Przygotuj środowisko: upewnij się, że masz dostęp do kodu źródłowego starego API, jego specyfikacji OpenAPI, skonfigurowane środowisko docelowe (nowy framework lub platforma) oraz narzędzia do routowania ruchu (reverse proxy, feature flags lub API gateway).

2. Wyzwól skill frazą "migrate the API", "upgrade API version" lub "migrate to new API" w Claude, Codex lub OpenClaw. Skill użyje narzędzi Read, Write, Edit, Grep i Bash do analizy.

3. Pozwól skillowi na inventaryzację wszystkich endpointów: narzędzie przeskanuje kod i dokumentację, dokumentując metody HTTP, wzorce URL, schematy żądań i odpowiedzi, mechanizmy autentykacji oraz zależności konsumentów API.

4. Przejrzyj wygenerowaną tabelę mapowania endpointów, która paruje każdy stary endpoint z jego odpowiednikiem w nowej wersji i wskazuje breaking changes (zmiany struktury URL, nazw pól, typów danych, przepływu autentykacji).

5. Zaakceptuj utworzone adaptery transformujące format żądań i odpowiedzi – skill obsługuje zmianę nazw pól, konwersje zagnieżdżonych struktur na płaskie i zmiany wartości enum.

6. Wdróż router ruchu (reguły reverse proxy lub middleware) na podstawie planu migracji, aby kierować żądania do starego lub nowego API w zależności od fazy migracji, endpointu lub feature flag, aż do pełnego przejścia.