firecrawl-upgrade-migration

Skill do zarządzania aktualizacjami biblioteki @mendable/firecrawl-js i migracji z API v0 na v1/v2. Analizuje zmiany w sygnaturach metod, formatach odpowiedzi i ścieżkach importu. Wykrywa breaking changes między wersjami SDK, automatyzuje testy po upgrade'u i prowadzi Cię przez proces migracji kodu. Użyj go, gdy chcesz zaktualizować FireCrawl, obsługiwać nowe API lub przejść na najnowszą wersję v2.

1. Aktywuj skill w Claude Code, Codex lub OpenClaw i powiedz mu, że chcesz zaktualizować FireCrawl SDK — użyj fraz takich jak "upgrade firecrawl", "firecrawl migration", "firecrawl v2" lub "firecrawl breaking changes".

2. Skill sprawdzi aktualnie zainstalowaną wersję @mendable/firecrawl-js w Twoim projekcie za pomocą npm list i porówna ją z najnowszą dostępną wersją.

3. Skill utworzy gałąź git upgrade/firecrawl-sdk, zainstaluje najnowszą wersję SDK i uruchomi testy, aby upewnić się, że aktualizacja nie złamała funkcjonalności.

4. Skill przeanalizuje zmiany między wersjami — szczególnie w metodach crawlUrl (v0 używała waitUntilDone, v1+ używa asyncCrawlUrl i checkCrawlStatus), formatach odpowiedzi i schemacie extract v2.

5. Skill wygeneruje plan migracji kodu, wskazując miejsca, gdzie trzeba zmienić sygnatury metod, opcje parametrów i obsługę odpowiedzi API.

6. Przejrzyj sugerowane zmiany, zatwierdź je w edytorze, a skill pomoże Ci przetestować zmigrowany kod przed mergem do głównej gałęzi.