Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Taitojen hallinta: löytäminen, aktivointi ja prioriteetti

Oppitunti 7 / 14 Päivitetty 2. marraskuuta 2026 Edistynyt
Tällä sivulla
  1. Miten Vibe löytää taidot
  2. Taitohakemiston rakenne
  3. Taitojen ottaminen käyttöön ja poistaminen käytöstä
  4. Suodatuskuviot
  5. Kaksi samannimistä taitoa
  6. Projektikohtainen konfiguraatio
  7. Keskeiset asiat

Oppitunti päivitetty 2. marraskuuta 2026 Vibe-dokumentaation Skills-sivun perusteella: lisätty .agents/skills/-sijainnit, virallinen löytämisjärjestys (mukautetut polut, projekti, käyttäjä) ja /reload-komento. Dokumentaatiossa ei määritellä prioriteettisääntöä kahdelle samannimiselle taidolle; edellinen versio kuvasi sellaisen. Lähde: Skills.

Miten Vibe löytää taidot

Taidon kirjoittaminen on yksi asia; tietää, mikä niistä todella suoritetaan, on toinen. Dokumentaatio määrittelee järjestyksen, jossa Vibe löytää taidot:

  1. Mukautetut polut, jotka on ilmoitettu tiedostossa config.toml käyttäen avainta skill_paths;
  2. Projektin taidot, jotka sijaitsevat kansioissa ./.vibe/skills/ tai ./.agents/skills/. Ne ladataan vain, jos kansio on luotettu;
  3. Käyttäjän taidot, jotka sijaitsevat kansioissa ~/.vibe/skills/ tai ~/.agents/skills/.

Kansiot .agents/skills/ noudattavat avointa Agent Skills -määritystä: sinne tallennettu taito jaetaan muiden agenttien kanssa, jotka omaksuvat saman määrityksen. Aktiivinen istunto poimii lisätyt tai muokatut taidot automaattisesti; jos muutos ei näy, kirjoita /reload.

Taitohakemiston rakenne

Yleiset taidot sijaitsevat kotihakemistossasi, kukin omassa kansiossaan, joka sisältää tiedoston SKILL.md. Ne ovat käytettävissä kaikkialla, jokaisessa projektissa, jossa ajat Vibeä.

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

Paikalliset taidot sen sijaan versioidaan yhdessä projektikoodin kanssa. Tämä on luonteva paikka käyttöönotto- tai migraatiotaidoille, jotka riippuvat repositorion tarkasta infrastruktuurista eivätkä olisi järkeviä muualla.

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

Lopuksi on olemassa mukautettuja polkuja, joilla viitataan muualla järjestelmässäsi sijaitseviin taitoihin. Ilmoitat nämä konfiguraatiossa:

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

Tämä on ensisijainen mekanismi taitojen jakamiseen tiimin sisällä verkkokansion tai kloonatun Git-repositorion kautta, jonka kaikki päivittävät omalla koneellaan.

Taitojen ottaminen käyttöön ja poistaminen käytöstä

Oletusarvoisesti kaikki löydetyt taidot ovat aktiivisia. Kaksi symmetristä asetusta antaa sinulle mahdollisuuden ottaa kontrolli takaisin. Asetuksella enabled_skills siirryt valkolistaan: vain luetellut taidot ovat aktiivisia; kaikki muut jätetään huomiotta.

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

Asetuksella disabled_skills pysyt mustalistassa: kaikki taidot ovat aktiivisia lukuun ottamatta nimeämiäsi. Tämä on oikea valinta, kun yksittäinen taito on väliaikaisesti tielläsi.

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

Suodatuskuviot

Molemmat kentät hyväksyvät kolmea syötteen muotoa. Yksinkertaisin on tarkka nimi, joka toimii niin kauan kuin lista pysyy lyhyenä:

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

Glob-kuviot astuvat kuvaan, kun nimesi noudattavat sopimusta. Merkki * vastaa mitä tahansa merkkijonoa, jolloin voit hallita koko perhettä yhdellä rivillä:

# Ota käyttöön kaikki taidot, jotka alkavat merkkijonolla "test-"
enabled_skills = ["test-*"]

# Poista käytöstä kaikki kokeelliset taidot
disabled_skills = ["experimental-*", "beta-*"]

Tapauksissa, joita globit eivät kata – vaihtoehto, kuvio nimen keskellä, numeerinen pääte – lisää lausekkeen eteen re: käyttääksesi säännöllistä lauseketta:

# Ota käyttöön taidot, joiden nimessä on "review" tai "audit"
enabled_skills = ["re:review|audit"]

# Poista käytöstä versioituja taitoja (esim. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+']   # merkkijonoliteraali: kenoviivaa ei tarvitse merkitä erikseen

Kaksi samannimistä taitoa

Dokumentaatio ei kuvaile prioriteettisääntöä kahdelle samannimiselle taidolle eri sijainneissa. Älä siis luota implisiittiseen “ylikirjoitukseen”: anna niille eri nimet (code-review-backend toisen code-review-taidon sijaan) ja varmista, mikä todella ladataan. Valikossa / kunkin taidon kuvaus alkaa sen laajuudella: project, user tai vibe, mikä riittää kaksoiskappaleen havaitsemiseen. Taito, jonka nimi on sama kuin sisäänrakennetulla komennolla, ei näy tässä valikossa.

Projektikohtainen konfiguraatio

Kaikki nämä asetukset yhdistyvät tiedostoon .vibe/config.toml, joka sijoitetaan projektin juureen. Alla oleva esimerkki näyttää kaikki kolme vipua yhdessä: rajoita lista asiaankuuluviin taitoihin, sulje pois ne, jotka eivät kuulu asiaan, ja lisää backend-tiimin jaettu kansio.

# mon-projet/.vibe/config.toml

# Ota käyttöön vain tähän projektiin liittyvät taidot
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]

# Tai poista käytöstä ne, jotka eivät liity asiaan
disabled_skills = ["doc-writer"]

# Lisää muita polkuja
skill_paths = ["/home/equipe/backend-skills"]

Varmistaaksesi, mitkä taidot ovat todella saatavilla, avaa /-valikko istunnossa: jokainen taito näkyy siellä laajuutensa kanssa. Tämä on ensimmäinen refleksi, kun odotettu vinokomento puuttuu, ennen kuin kokeilet /reload-komentoa ja tarkistat kansion luotettavuustilan.

Keskeiset asiat

  • Vibe löytää taidot hakemistoista ~/.vibe/skills/, .vibe/skills/ ja mukautetuista skill_paths-poluista
  • Paikalliset taidot ovat etusijalla yleisiin taitoihin nähden
  • Käytä enabled_skills tai disabled_skills -asetuksia aktivoinnin hallintaan
  • Glob-kuviot (test-*) ja regex-lausekkeet (re:review|audit) yksinkertaistavat suodatusta
  • Luo .vibe/config.toml jokaiselle projektille kontekstin mukauttamiseksi
  • Jaa taitoja tiimin kesken käyttämällä skill_paths-asetusta, joka osoittaa yhteiseen kansioon