| name | sync-template |
| description | Aktualizuje maszynerię workflow (.claude/: skille, agenci, reguły, hooki, workflows, templates + settings.json) w bieżącym projekcie, zaciągając najnowszą wersję z repo szablonu claude-code-starter. Jednym uruchomieniem sprawdza czy w szablonie pojawiły się jakiekolwiek zmiany i automatycznie je aplikuje. Używaj gdy: „zaktualizuj szablon", „zsynchronizuj .claude", „zaciągnij zmiany z szablonu", „sync template", „czy są nowe skille/agenci", „update workflow", „odśwież folder Claude" — a także po wrzuceniu tego szablonu do nowego projektu, żeby dociągnąć maszynerię. Wywołuj TEN skill zawsze gdy user chce zsynchronizować konfigurację Claude Code z centralnym szablonem, nawet jeśli nie nazwie tego wprost „synchronizacją". |
| argument-hint | [opcjonalnie: --dry-run (tylko podgląd), --force (aplikuj mimo tej samej wersji)] |
sync-template — aktualizacja maszynerii workflow z szablonu
Zaciąga najnowszą wersję folderu .claude/ z centralnego repo szablonu
AIBiz-Automatyzacje/claude-code-starter (branch main) do bieżącego projektu.
Powstał, żeby po wrzuceniu szablonu do innego projektu nie trzeba było ręcznie
dyktować linku i prosić o aktualizację — jedno uruchomienie sprawdza, czy w
szablonie coś się zmieniło, i automatycznie to aplikuje.
Model działania (ważne — tak zdecydował user)
- Zakres: tylko maszyneria
.claude/ — skills/, agents/, rules/,
hooks/, workflows/, templates/, docs/ oraz settings.json. Nie rusza
settings.local.json (lokalny), rootowego README.md/CLAUDE.md ani docs/ projektu.
- Szablon zawsze wygrywa: pliki wspólne są nadpisywane wersją z szablonu, także
gdy były lokalnie modyfikowane. Nadpisywane i usuwane pliki najpierw trafiają do
backupu (ścieżka odwrotu) — user nie musi tego zatwierdzać.
- Tryb w pełni automatyczny: aplikuj od razu, bez pytania o potwierdzenie planu.
Raport podsumowujący pokaż dopiero na końcu.
- Pliki lokalne projektu są bezpieczne: cokolwiek istnieje lokalnie, a czego
szablon nigdy nie miał (np. własny skill projektu), pozostaje nietknięte. Usuwane
są wyłącznie pliki, które szablon wcześniej dostarczał, a teraz je wycofał
(wykrywane przez manifest
.claude/.template-manifest).
Wykonanie
Uruchom bundlowany skrypt — robi całość deterministycznie (klon → porównanie SHA →
klasyfikacja → backup → apply → aktualizacja markera wersji i manifestu):
bash .claude/skills/sync-template/scripts/sync-template.sh
Skrypt sam wykrywa katalog projektu ($CLAUDE_PROJECT_DIR → git toplevel → pwd),
klonuje szablon płytko do katalogu tymczasowego przez git/istniejące
poświadczenia (gh auth/git credentials) i sprząta po sobie.
Argumenty (przekaż dalej, jeśli user o nie poprosił):
--dry-run — pokaż co by się zmieniło, nic nie zapisuj (przydatne, gdy user
chce najpierw zobaczyć skalę zmian, mimo domyślnie automatycznego trybu).--force — aplikuj nawet gdy SHA szablonu = ostatni zsynchronizowany (np. gdy
ktoś ręcznie namieszał w .claude/ i chce twardy reset do wersji z szablonu).
Odczyt wyniku skryptu
Skrypt wypisuje ustrukturyzowany raport, który streszczasz userowi po polsku:
STATUS: UP_TO_DATE → szablon aktualny. Powiedz krótko „Szablon jest aktualny,
brak zmian do zaciągnięcia" i zakończ. Nie kombinuj dalej.STATUS: CHANGES + COUNTS: nowe=… zmienione=… usuniete=… bez_zmian=… →
podsumuj liczby i wypisz konkretne pozycje z sekcji NOWE/ZMIENIONE/USUNIETE
(to interesuje usera najbardziej — jakie skille/agenci przybyły albo się zmieniły).APPLIED: … → potwierdź, że zmiany zaaplikowano.BACKUP: <ścieżka> → podaj userowi tę ścieżkę jako punkt odwrotu (tam są
poprzednie wersje nadpisanych/usuniętych plików).
Obsługa błędów
BŁĄD: nie udało się sklonować… → repo może być prywatne lub brak sieci.
Przekaż userowi stderr z git i zasugeruj gh auth login / sprawdzenie sieci.
Nie ponawiaj w kółko tej samej komendy.BŁĄD: brak 'git' w PATH → git nie jest zainstalowany; zgłoś to userowi.
Nie modyfikuj skryptu „w locie", żeby obejść błąd konfiguracji — zdiagnozuj przyczynę.
Higiena repo
Katalog backupów .claude/.backups/ i pliki .claude/.template-version /
.claude/.template-manifest to lokalne bookkeeping — zasugeruj userowi dodanie
.claude/.backups/ do .gitignore projektu, jeśli jeszcze go tam nie ma.
Uwagi techniczne
- Skrypt jest zgodny z bash 3.2 (domyślny na macOS) — bez associative arrays.
settings.json (współdzielona konfiguracja szablonu) jest nadpisywany; lokalne
nadpisania konfiguracji projekt trzyma w settings.json local — czyli
settings.local.json, którego skrypt nigdy nie dotyka.agent-browser aktualizuje się przez repo jak każdy inny skill; jego twarda
synchronizacja z upstream CLI (vercel-labs) to osobny proces opisany w
ZRODLA-SZABLONU.md — nie mieszaj tych dwóch.
