cartographer
Automatycznie mapuj i dokumentuj architekturę swoich projektów za pomocą równoległych agentów AI
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Cartographer to umiejętność do Claude'a, która tworzy szczegółową dokumentację struktury kodu. Skanuje repozytoria dowolnej wielkości, analizuje zależności między plikami i generuje mapę w pliku docs/CODEBASE_MAP.md. Narzędzie automatycznie wykrywa istniejące mapy i aktualizuje tylko zmienione sekcje. Idealne do onboardingu do nowych projektów lub zrozumienia złożonych architektur.
Jak używać
Zainstaluj umiejętność Cartographer w swoim środowisku Claude'a, dodając ją do konfiguracji pluginów.
Uruchom polecenie skanowania, aby uzyskać przegląd struktury projektu. Użyj komendy: uv run ${CLAUDE_PLUGIN_ROOT}/skills/cartographer/scripts/scan-codebase.py . --format json. Jeśli uv nie jest dostępne, spróbuj bezpośredniego uruchomienia skryptu Pythona.
Poproś Claude'a o mapowanie kodu, używając jednej z fraz: "map this codebase", "cartographer", "/cartographer", "create codebase map", "document the architecture" lub "understand this codebase".
Cartographer sprawdzi, czy mapa już istnieje. Jeśli tak, porówna ostatnią datę mapowania z bieżącymi zmianami w repozytorium (używając git log lub ponownego skanowania).
Jeśli są zmiany, narzędzie uruchomi równoległe analizy za pomocą subagentów, którzy przeanalizują grupy plików i wygenerują raporty.
Wynik zostanie zapisany w docs/CODEBASE_MAP.md z architekturą, celami plików, zależnościami i przewodnikami nawigacji. Plik CLAUDE.md zostanie zaktualizowany podsumowaniem wskazującym na mapę.