axiom-database-migration
Bezpieczne migracje bazy danych dla aplikacji iOS/macOS bez utraty danych
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do Claude'a, który przeprowadza Cię przez bezpieczne zmiany schematu bazy danych SQLite w aplikacjach produkcyjnych. Pomaga uniknąć typowych błędów migracji takich jak "FOREIGN KEY constraint failed", "no such column" czy "cannot add NOT NULL column". Pokazuje prawidłowe wzorce: dodawanie kolumn jako nullable, backfill danych, dodawanie indeksów i nigdy nie usuwanie starych kolumn. Migracje są niezmienne po wydaniu aplikacji — skill wyjaśnia, jak tworzyć nowe migracje zamiast modyfikować istniejące.
Jak używać
Zainstaluj skill axiom-database-migration w Claude'a, wskazując repozytorium https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/axiom-database-migration.
Kiedy planujesz zmianę schematu bazy danych (dodanie kolumny, zmianę typu, dodanie klucza obcego), opisz Claude'owi swój problem: jaką zmianę chcesz wprowadzić, jaki błąd otrzymujesz, czy aplikacja jest już w produkcji z danymi użytkowników.
Skill automatycznie zasugeruje bezpieczny wzorzec migracji. Dla nowych kolumn: najpierw dodaj kolumnę jako nullable, następnie backfilluj dane w osobnej migracji, dopiero wtedy dodaj ograniczenia. Dla zmian typu: utwórz nową kolumnę, przepisz dane, oznacz starą jako deprecated.
Dla błędów "cannot add NOT NULL column" — skill wyjaśni, że istniejące wiersze nie mają wartości. Rozwiązanie: dodaj kolumnę nullable, ustaw wartości domyślne, potem zmień na NOT NULL w osobnej migracji.
Jeśli dostajesz błędy "FOREIGN KEY constraint failed" przy dodawaniu relacji: najpierw dodaj kolumnę klucza obcego, wypełnij istniejące wiersze wartościami, dopiero wtedy dodaj indeks i ograniczenie (SQLite ma ograniczenia w ALTER TABLE).
Pamiętaj: migracje są niezmienne po wydaniu aplikacji. Jeśli migracja jest już w produkcji i odkryjesz błąd, utwórz nową migrację naprawczą zamiast modyfikować starą — skill pomoże Ci zaplanować poprawkę bez utraty danych.