Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Oskuste haldus: avastamine, aktiveerimine ja prioriteet

Õppetund 7 / 14 Värskendatud 2. november 2026 Edasijõudnutele
Sellel lehel
  1. Kuidas Vibe oskusi avastab
  2. Oskuste kataloogide struktuur
  3. Oskuste lubamine ja keelamine
  4. Filtrimismustrid
  5. Kaks sama nimega oskust
  6. Projektitasandi konfiguratsioon
  7. Peamised punktid

Tund uuendatud 2. novembril 2026 vastavalt Vibe dokumentatsiooni lehele Skills: lisatud asukohad .agents/skills/, ametlik avastamise järjekord (kohandatud rajad, projekt, kasutaja) ja käsk /reload. Dokumentatsioon ei määratle prioriteedireeglit kahe sama nimega oskuse korral; eelmine versioon kirjeldas sellist reeglit. Allikas: Skills.

Kuidas Vibe oskusi avastab

Oskuse kirjutamine on üks asi, teine aga teada saada, milline neist tegelikult käivitub. Dokumentatsioon täpsustab järjekorda, milles Vibe oskusi avastab:

  1. Kohandatud rajad, mis on deklareeritud failis config.toml võtmega skill_paths;
  2. Projekti oskused, asukohas ./.vibe/skills/ või ./.agents/skills/, laaditakse ainult siis, kui kaust on usaldusväärne;
  3. Kasutaja oskused, asukohas ~/.vibe/skills/ või ~/.agents/skills/.

Kaustad .agents/skills/ järgivad avatud Agent Skills spetsifikatsiooni: sinna salvestatud oskus on jagatud teiste agentidega, mis kasutavad sama spetsifikatsiooni. Aktiivne seanss tuvastab lisatud või muudetud oskused automaatselt; kui muutus ei ilmu, sisesta käsk /reload.

Oskuste kataloogide struktuur

Globaalsed oskused asuvad sinu kodukataloogis, igaüks omaendas kaustas, mis sisaldab faili SKILL.md. Need on saadaval kõikjal, igas projektis, kus Vibe’i käivitad.

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

Kohalikud oskused seevastu versioneeritakse koos projekti koodiga. See on loomulik koht näiteks juurutamise või andmebaasi migratsiooni oskuse jaoks, mis sõltub repositooriumi täpsest taristust ja oleks mujal mõttetu.

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

Lõpuks on olemas kohandatud rajad, mida kasutatakse viitamaks oskustele, mis asuvad mujal sinu süsteemis. Need deklareerid konfiguratsioonis:

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

See on eelistatud mehhanism oskuste jagamiseks meeskonna sees, kasutades võrgukausta või kloonitud Git-repositooriumi, mida igaüks oma poolel uuendab.

Oskuste lubamine ja keelamine

Vaikimisi on kõik avastatud oskused aktiivsed. Kaks sümmeetrilist seadet annavad sulle võimaluse kontrolli tagasi võtta. Võtmega enabled_skills lülitud valge nimekirja režiimile: aktiivsed on ainult loetletud oskused, ülejäänud ignoreeritakse.

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

Võtmega disabled_skills jääd musta nimekirja režiimile: kõik oskused on aktiivsed, välja arvatud need, mida nimetad. See on õige valik, kui üksainus oskus ajutiselt takistusi tekitab.

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

Filtrimismustrid

Mõlemad väljad aktsepteerivad kolme sisendivormi. Lihtsaim on täpne nimi, mis toimib seni, kuni nimekiri jääb lühikeseks:

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

Glob-mustrid tulevad mängu siis, kui sinu nimed järgivad kindlat konventsiooni. Märk * sobitub mis tahes märgijadaga, võimaldades terve perekonna korraga hallata:

# Luba kõik oskused, mis algavad "test-"
enabled_skills = ["test-*"]

# Keela kõik eksperimentaalsed oskused
disabled_skills = ["experimental-*", "beta-*"]

Juhtudeks, mida glob-mustrid ei kata – alternatiiv, muster nime keskel või numbriline sufiks – lisa avaldise ette eesliide re:, et kasutada regulaaravaldist:

# Luba oskused, mille nimes sisaldub "review" või "audit"
enabled_skills = ["re:review|audit"]

# Keela versioneeritud oskused (nt "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+']   # sõnesõnaline string: kaldkriipsu ei pea ekraanima

Kaks sama nimega oskust

Dokumentatsioon ei kirjelda prioriteedireeglit kahe erinevas asukohas oleva sama nimega oskuse korral. Seega ära looda vaikimisi „ülekirjutamisele“: anna neile erinevad nimed (code-review-backend teise code-review asemel) ja kontrolli, mis tegelikult laaditakse. Menüüs / algab iga oskuse kirjeldus selle ulatusega: project, user või vibe, mis piisab dubleerimise märkamiseks. Oskus, mille nimi kattub sisseehitatud käsuga, selles menüüs ei ilmu.

Projektitasandi konfiguratsioon

Kõik need seaded kombineeruvad failis .vibe/config.toml, mis asub projekti juurkataloogis. Allpool olev näide toob kokku kõik kolm hooba: piira nimekiri asjakohaste oskustega, välista need, mis ei sobi, ja lisa backend-meeskonna ühine kaust.

# mon-projet/.vibe/config.toml

# Luba ainult selle projektiga seotud oskused
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]

# Või keela need, mis ei ole asjakohased
disabled_skills = ["doc-writer"]

# Lisa täiendavad rajad
skill_paths = ["/home/equipe/backend-skills"]

Et kontrollida, millised oskused tegelikult saadaval on, ava seansis menüü /: iga oskus ilmub sinna koos oma ulatusega. See on esimene refleks, kui oodatud kaldkriipsu käsk puudub, enne kui proovid käsku /reload ja kontrollid kausta usaldusstaatust.

Peamised punktid

  • Vibe avastab oskused asukohtadest ~/.vibe/skills/, .vibe/skills/ ja kohandatud skill_paths
  • Kohalikud oskused on globaalsetest prioriteetsemad
  • Kasuta aktiveerimise juhtimiseks võtmeid enabled_skills või disabled_skills
  • Glob-mustrid (test-*) ja regex (re:review|audit) lihtsustavad filtreerimist
  • Loo projekti kohta .vibe/config.toml, et kohandada konteksti
  • Jaga oskusi meeskonnas, suunates skill_paths ühisele kaustale