Gestionarea competențelor: descoperire, activare și prioritate
Pe această pagină
Lecție actualizată la 2 noiembrie 2026 pe baza paginii Skills din documentația Vibe: au fost adăugate locațiile
.agents/skills/, ordinea oficială de descoperire (căi personalizate, proiect, utilizator) și comanda/reload. Documentația nu definește o regulă de prioritate pentru două competențe cu același nume; versiunea anterioară descria una. Sursă: Skills.
Cum descoperă Vibe competențele
Scrierea unei competențe este un lucru; a ști care dintre ele rulează efectiv este altul. Documentația specifică ordinea în care Vibe descoperă competențele:
- Căi personalizate declarate în
config.tomlfolosindskill_paths; - Competențele de proiect, situate în
./.vibe/skills/sau./.agents/skills/, încărcate doar dacă dosarul este de încredere; - Competențele de utilizator, situate în
~/.vibe/skills/sau~/.agents/skills/.
Dosarele .agents/skills/ respectă specificația deschisă Agent Skills: o competență stocată acolo este partajată cu alți agenți care adoptă aceeași specificație. O sesiune activă preia competențele adăugate sau modificate; dacă o modificare nu apare, tastați /reload.
Structura dosarului de competențe
Competențele globale se află în dosarul dumneavoastră personal, fiecare în propriul subdosar care conține un fișier SKILL.md. Acestea sunt disponibile peste tot, în fiecare proiect în care rulați Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Competențele locale, pe de altă parte, sunt versionate împreună cu codul proiectului. Acesta este locul natural pentru o competență de implementare sau migrare, care depinde de infrastructura exactă a depozitului și nu ar avea sens în altă parte.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
În final, există căi personalizate, utilizate pentru a face referire la competențe situate în alte locuri pe sistemul dumneavoastră. Le declarați în configurație:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Acesta este mecanismul preferat pentru partajarea competențelor într-o echipă, printr-un dosar de rețea sau un depozit Git clonat pe care toată lumea îl actualizează la nivelul său.
Activarea și dezactivarea competențelor
Implicit, toate competențele descoperite sunt active. Două setări simetrice vă permit să preluați controlul. Cu enabled_skills, treceți la o listă albă: doar competențele listate sunt active; toate celelalte sunt ignorate.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Cu disabled_skills, rămâneți la o listă neagră: toate competențele sunt active, cu excepția celor pe care le numiți. Aceasta este alegerea corectă atunci când o singură competență vă stă temporar în cale.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Modele de filtrare
Ambele câmpuri acceptă trei forme de intrare. Cea mai simplă este numele exact, care funcționează atâta timp cât lista rămâne scurtă:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Modelele glob preiau controlul odată ce numele dumneavoastră respectă o convenție. Caracterul * corespunde oricărei secvențe de caractere, permițându-vă să gestionați o întreagă familie într-o singură linie:
# Activează toate competențele care încep cu "test-"
enabled_skills = ["test-*"]
# Dezactivează toate competențele experimentale
disabled_skills = ["experimental-*", "beta-*"]
Pentru cazurile pe care globurile nu le acoperă—o alternativă, un model în mijlocul unui nume, un sufix numeric—prefixați expresia cu re: pentru a utiliza o expresie regulată:
# Activează competențele al căror nume conține "review" sau "audit"
enabled_skills = ["re:review|audit"]
# Dezactivează competențele versionate (de ex. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # șir literal: bara oblică inversă nu necesită escapare
Două competențe cu același nume
Documentația nu descrie o regulă de prioritate pentru două competențe care poartă același nume în locații diferite. Așadar, nu vă bazați pe o „suprascriere“ implicită: dați-le nume distincte (code-review-backend în loc de un al doilea code-review) și verificați ce este încărcat efectiv. În meniul /, descrierea fiecărei competențe începe cu domeniul său de aplicare, project, user sau vibe, ceea ce este suficient pentru a identifica un duplicat. O competență numită la fel ca o comandă încorporată nu apare în acest meniu.
Configurația la nivel de proiect
Toate aceste setări se combină într-un fișier .vibe/config.toml plasat în rădăcina proiectului. Exemplul de mai jos arată cele trei pârghii împreună: restricționați lista la competențele relevante, excludeți-le pe cele care nu sunt și adăugați dosarul partajat al echipei backend.
# mon-projet/.vibe/config.toml
# Activează doar competențele relevante pentru acest proiect
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Sau dezactivează-le pe cele care nu sunt relevante
disabled_skills = ["doc-writer"]
# Adaugă căi suplimentare
skill_paths = ["/home/equipe/backend-skills"]
Pentru a verifica ce competențe sunt disponibile efectiv, deschideți meniul / în sesiune: fiecare competență apare acolo cu domeniul său de aplicare. Acesta este primul reflex atunci când o comandă slash așteptată lipsește, înainte de a încerca /reload și de a verifica statutul de încredere al dosarului.
Puncte cheie
- Vibe descoperă competențele în
~/.vibe/skills/,.vibe/skills/și înskill_pathspersonalizate - Competențele locale au prioritate față de cele globale
- Utilizați
enabled_skillssaudisabled_skillspentru a controla activarea - Modelele glob (
test-*) și regex (re:review|audit) simplifică filtrarea - Creați un
.vibe/config.tomlper proiect pentru a personaliza contextul - Partajați competențele într-o echipă prin
skill_pathscare indică spre un dosar comun