cartography

Skill do zrozumienia i wizualizacji budowy projektów. Analizuje strukturę repozytorium, tworzy hierarchiczne mapy kodu i śledzi zmiany w plikach. Idealny gdy zaczynacie pracę nad nieznanym kodem lub chcecie udokumentować architekturę projektu. Automatycznie pomija testy, dokumentację i zależności, skupiając się na kodzie źródłowym.

1. Sprawdź, czy w katalogu głównym repozytorium istnieje plik .slim/cartography.json. Jeśli tak, przejdź do kroku 5. Jeśli nie, kontynuuj.

2. Uruchom inicjalizację skilla poleceniem python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py init --root ./ --include "src/**/*.ts" --exclude "**/*.test.ts" --exclude "dist/**" --exclude "node_modules/**". Dostosuj ścieżki --include i --exclude do struktury swojego projektu — na przykład dla projektu Python użyj src/**/*.py zamiast *.ts. Polecenie utworzy plik stanu .slim/cartography.json i puste pliki codemap.md w każdym katalogu.

3. Skill automatycznie deleguje pracę agentem eksploracyjnym — każdy agent czyta kod w przydzielonym mu folderze i wypełnia odpowiadający mu plik codemap.md opisem struktury i funkcjonalności.

4. Po zakończeniu eksploracji przejrzyj wygenerowane pliki codemap.md w podkatalogach. Zawierają one hierarchiczną mapę kodu z opisami modułów i ich powiązań.

5. Aby śledzić zmiany w kodzie, uruchom python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py changes --root ./. Polecenie pokaże dodane, usunięte i zmodyfikowane pliki od ostatniej inicjalizacji.

6. Jeśli kod się zmienił znacząco, uruchom ponownie inicjalizację lub ręcznie zaktualizuj odpowiednie pliki codemap.md — skill automatycznie zaktualizuje stan w .slim/cartography.json.