Przejdź do głównej treści
Polski— Wybierz język
Menu

Zarządzanie umiejętnościami: wykrywanie, aktywacja i priorytety

Lekcja 7 z 14 Zaktualizowano 2 listopada 2026 Zaawansowany
Na tej stronie
  1. Jak Vibe wykrywa umiejętności
  2. Struktura katalogów umiejętności
  3. Włączanie i wyłączanie umiejętności
  4. Wzorce filtrowania
  5. Dwie umiejętności o tej samej nazwie
  6. Konfiguracja na poziomie projektu
  7. Kluczowe wnioski

Lekcja zaktualizowana 2 listopada 2026 r. na podstawie strony dokumentacji Vibe Skills: dodano lokalizacje .agents/skills/, oficjalną kolejność wykrywania (ścieżki niestandardowe, projekt, użytkownik) oraz polecenie /reload. Dokumentacja nie definiuje reguły priorytetu dla dwóch umiejętności o tej samej nazwie; poprzednia wersja taką opisywała. Źródło: Skills.

Jak Vibe wykrywa umiejętności

Napisanie umiejętności to jedno, ale wiedza, która z nich faktycznie zostanie uruchomiona, to co innego. Dokumentacja precyzuje kolejność, w jakiej Vibe wykrywa umiejętności:

  1. Ścieżki niestandardowe zadeklarowane w pliku config.toml za pomocą skill_paths;
  2. Umiejętności projektowe, znajdujące się w ./.vibe/skills/ lub ./.agents/skills/, ładowane tylko wtedy, gdy folder jest zaufany;
  3. Umiejętności użytkownika, znajdujące się w ~/.vibe/skills/ lub ~/.agents/skills/.

Foldery .agents/skills/遵循 otwartą specyfikację Agent Skills: umiejętność tam zapisana jest współdzielona z innymi agentami przyjmującymi tę samą specyfikację. Aktywna sesja automatycznie wykrywa dodane lub zmodyfikowane umiejętności; jeśli zmiany nie są widoczne, wpisz /reload.

Struktura katalogów umiejętności

Umiejętności globalne znajdują się w Twoim katalogu domowym, każda we własnym folderze zawierającym plik SKILL.md. Są dostępne wszędzie, w każdym projekcie, w którym uruchamiasz Vibe.

~/.vibe/skills/
├── code-review/
│   └── SKILL.md
├── test-generator/
│   └── SKILL.md
└── doc-writer/
    └── SKILL.md

Umiejętności lokalne są natomiast wersjonowane razem z kodem projektu. To naturalne miejsce na umiejętność wdrażania lub migracji, która zależy od dokładnej infrastruktury repozytorium i nie miałaby sensu gdzie indziej.

mon-projet/
├── .vibe/
│   └── skills/
│       ├── deploy-prod/
│       │   └── SKILL.md
│       └── db-migrate/
│           └── SKILL.md
├── src/
└── package.json

Na koniec mamy ścieżki niestandardowe, służące do odwoływania się do umiejętności znajdujących się w innych miejscach systemu. Deklarujesz je w konfiguracji:

# ~/.vibe/config.toml
skill_paths = [
  "/home/equipe/shared-skills",
  "/opt/company-skills"
]

Jest to preferowany mechanizm udostępniania umiejętności w zespole, poprzez folder sieciowy lub sklonowane repozytorium Git, które każdy aktualizuje po swojej stronie.

Włączanie i wyłączanie umiejętności

Domyślnie wszystkie wykryte umiejętności są aktywne. Dwa symetryczne ustawienia pozwalają przejąć nad nimi kontrolę. Dzięki enabled_skills przechodzisz na białą listę: aktywne są tylko wymienione umiejętności, pozostałe są ignorowane.

# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]

Z kolei disabled_skills utrzymuje czarną listę: wszystkie umiejętności są aktywne z wyjątkiem tych, które wymienisz. To właściwy wybór, gdy pojedyncza umiejętność tymczasowo Ci przeszkadza.

# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]

Wzorce filtrowania

Oba pola acceptują trzy formy danych wejściowych. Najprostsza to dokładna nazwa, co działa tak długo, jak lista pozostaje krótka:

enabled_skills = ["code-review", "test-generator", "doc-writer"]

Wzorce glob przejmują kontrolę, gdy Twoje nazwy遵循ują konwencję. Znak * dopasowuje dowolny ciąg znaków, pozwalając obsłużyć całą rodzinę umiejętności w jednej linii:

# Włącz wszystkie umiejętności zaczynające się od "test-"
enabled_skills = ["test-*"]

# Wyłącz wszystkie umiejętności eksperymentalne
disabled_skills = ["experimental-*", "beta-*"]

W przypadkach, których globy nie obejmują – alternatywa, wzorzec w środku nazwy, sufiks numeryczny – poprzedź wyrażenie przedrostkiem re:, aby użyć wyrażenia regularnego:

# Włącz umiejętności, których nazwa zawiera "review" lub "audit"
enabled_skills = ["re:review|audit"]

# Wyłącz umiejętności z wersjami (np. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+']   # ciąg literalny: ukośnik odwrotny nie wymaga escapowania

Dwie umiejętności o tej samej nazwie

Dokumentacja nie opisuje reguły priorytetu dla dwóch umiejętności o tej samej nazwie znajdujących się w różnych lokalizacjach. Nie licz więc na domyślne „nadpisywanie“: nadaj im odrębne nazwy (np. code-review-backend zamiast drugiego code-review) i zweryfikuj, co jest faktycznie ładowane. W menu / opis każdej umiejętności zaczyna się od jej zakresu: project, user lub vibe, co wystarcza do wykrycia duplikatu. Umiejętność o nazwie identycznej jak wbudowane polecenie nie pojawia się w tym menu.

Konfiguracja na poziomie projektu

Wszystkie te ustawienia łączą się w pliku .vibe/config.toml umieszczonym w głównym katalogu projektu. Poniższy przykład pokazuje wszystkie trzy dźwignie razem: ograniczenie listy do odpowiednich umiejętności, wykluczenie tych niepotrzebnych i dodanie współdzielonego folderu zespołu backendowego.

# mon-projet/.vibe/config.toml

# Włącz tylko umiejętności istotne dla tego projektu
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]

# Lub wyłącz te, które nie są istotne
disabled_skills = ["doc-writer"]

# Dodaj dodatkowe ścieżki
skill_paths = ["/home/equipe/backend-skills"]

Aby sprawdzić, które umiejętności są faktycznie dostępne, otwórz menu / w sesji: każda umiejętność pojawia się tam wraz ze swoim zakresem. To pierwszy odruch, gdy oczekiwane polecenie ukośnikowe (/) nie działa, zanim spróbujesz /reload i sprawdzisz status zaufania folderu.

Kluczowe wnioski

  • Vibe wykrywa umiejętności w ~/.vibe/skills/, .vibe/skills/ oraz niestandardowych skill_paths
  • Umiejętności lokalne mają priorytet nad globalnymi
  • Użyj enabled_skills lub disabled_skills, aby kontrolować aktywację
  • Wzorce glob (test-*) i wyrażenia regularne (re:review|audit) upraszczają filtrowanie
  • Utwórz plik .vibe/config.toml dla każdego projektu, aby dostosować kontekst
  • Udostępniaj umiejętności w zespole poprzez skill_paths wskazujące na wspólny folder