Zarządzanie umiejętnościami: wykrywanie, aktywacja i priorytety
Na tej stronie
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:
- Ścieżki niestandardowe zadeklarowane w pliku
config.tomlza pomocąskill_paths; - Umiejętności projektowe, znajdujące się w
./.vibe/skills/lub./.agents/skills/, ładowane tylko wtedy, gdy folder jest zaufany; - 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 niestandardowychskill_paths - Umiejętności lokalne mają priorytet nad globalnymi
- Użyj
enabled_skillslubdisabled_skills, aby kontrolować aktywację - Wzorce glob (
test-*) i wyrażenia regularne (re:review|audit) upraszczają filtrowanie - Utwórz plik
.vibe/config.tomldla każdego projektu, aby dostosować kontekst - Udostępniaj umiejętności w zespole poprzez
skill_pathswskazujące na wspólny folder