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

Slash-komennot: käynnistä taidot yhdellä eleellä

Oppitunti 8 / 14 Päivitetty 2. marraskuuta 2026 Edistynyt
Tällä sivulla
  1. Pikanäppäimiä taidoillesi
  2. Taitojen suunnittelu ketjutettavaksi
  3. Mitä välität komennolle
  4. Luettavuuden säilyttäminen ajan myötä
  5. Keskeiset asiat

Oppitunti päivitetty 2. marraskuuta 2026 Vibe-dokumentaation perusteella: taidon slash-komento lisää taidon ohjeet viestiisi, ja disable-model-invocation: true varaa taidon manuaaliseen käynnistämiseen. Lähteet: Skills · Commands and shortcuts.

Pikanäppäimiä taidoillesi

Edellisissä oppitunneissa kirjoittamasi taidot ovat hyödyttömiä, ellei mikään kutsu niitä. Slash-komennot ovat tämä laukaisin: komentoja, jotka alkavat merkillä / ja jotka kirjoitat suoraan Vibe-istuntoon. Sinun ei tarvitse tehdä muita ilmoituksia – jokainen taito, jonka frontmatterissa on user-invocable: true, luo automaattisesti slash-komennon, joka kantaa taidon nimeä. Sinä kirjoitat tiedoston SKILL.md, ja Vibe huolehtii sen julkistamisesta.

Syntaksi mahtuu yhdelle riville: komennon nimi, jota seuraa se, mitä haluat sen käsittelevän.

# Vuorovaikutteisessa Vibe-istunnossa
/code-review src/api/auth.ts
/test-generator src/utils/helpers.ts
/doc-writer src/lib/database.ts

Vibe lisää viestiisi ohjeet tiedostosta SKILL.md yhdessä sen tekstin kanssa, jonka kirjoitit komennon jälkeen. Näiden taidoistasi johdettujen komentojen lisäksi Vibe tarjoaa sisäänrakennettuja komentoja, jotka ovat käytettävissä jokaisessa istunnossa:

/config          # Muokkaa Vibe-asetuksia
/help            # Näytä ohje
/clear           # Uusi keskustelu (alias /new)
/model           # Valitse aktiivinen malli
/resume          # Jatka tallennettua istuntoa
/compact         # Tiivistä historia vapauttaaksesi kontekstia
/reload          # Lataa asetukset, ohjeet ja taidot uudelleen

Taitojen suunnittelu ketjutettavaksi

Yksi slash-komento säästää muutaman sekunnin. Todellinen hyöty syntyy, kun niitä ketjutetaan: jokainen taito poimii langan siitä, mihin edellinen jäi. Tarkastellaan kahta toisiaan täydentävää taitoa: toinen siivoaa koodin ja toinen tekee siitä commitin.

Ensimmäinen, lint-fix, olettaa projektin työkalujen olevan jo konfiguroitu ja tarvitsee vain niiden orkestrointia oikeassa järjestyksessä.

---
name: lint-fix
description: Lintaa ja muotoile koodi projektin sääntöjen mukaan
license: MIT
user-invocable: true
allowed-tools:
  - read_file
  - write_file
  - bash
  - grep
---

# Lintaa ja korjaa

Suorita projektin linter ja muotoilija määritetyille tiedostoille.

## Prosessi

1. Havaitse linter (ESLint, Biome, oxlint)
2. Havaitse muotoilija (Prettier, Biome)
3. Suorita linttaus automaattisella korjauksella
4. Suorita muotoilu
5. Raportoi korjaamattomat virheet

Toinen, smart-commit, astuu kuvaan, kun koodi on siistiä. Huomaa ask_user_question sen sallittujen työkalujen listalla: commit-viestin kirjoittaminen vaikuttaa repositorion historiaan, joten on perusteltua, että taito kysyy vahvistusta ennen suorittamista.

---
name: smart-commit
description: Luo konventionaalinen commit-viesti muutoksista
license: MIT
user-invocable: true
allowed-tools:
  - bash
  - read_file
  - grep
  - ask_user_question
---

# Älykäs commit

Analysoi nykyiset Git-muutokset ja luo commit-viesti
noudattaen Conventional Commits -käytäntöä.

## Prosessi

1. Suorita `git diff --staged` nähdäksesi muutokset
2. Luokittele: feat, fix, refactor, docs, test, chore
3. Tunnista scope (päätiedosto tai moduuli)
4. Kirjoita ytimekäs viesti englanniksi
5. Pyydä käyttäjältä vahvistus
6. Suorita commit

Kun nämä taidot ovat paikallaan, kehityspäivä näyttää tältä: avaat istunnon, tutkit olemassa olevaa koodia, kirjoitat koodia ja suoritat sitten varmennusketjun ennen commitointia.

vibe

# Aamu: tutkiminen
/code-review src/

# Kehitys
# ... koodia ...

# Ennen commitia
/lint-fix src/
/test-generator src/new-file.ts
/smart-commit

Mitä välität komennolle

Kaikki komennon nimen jälkeen tuleva on vapaata tekstiä, joka välitetään taidolle kontekstina. Voit määrittää yksittäisen tiedoston, luetella useita tai antaa ohjeen luonnollisella kielellä polkujen luettelemisen sijaan.

# Välitä tietty tiedosto
/code-review src/api/users.ts

# Välitä useita tiedostoja
/test-generator src/utils/math.ts src/utils/string.ts

# Välitä ohjeita
/doc-writer Dokumentoi vain julkiset funktiot hakemistossa src/lib/

Kaikkien taitojesi ei tarvitse muuttua komennoiksi. Analyysitaitoa, jota muut taidot tai agentti kutsuvat, ei tarvita automaattiseen täydennykseen: aseta arvoksi user-invocable: false, jolloin se katoaa listasta mutta pysyy sisäisesti viitattavissa.

---
name: internal-analyzer
description: Muiden taitojen käyttämä sisäinen analyysi
user-invocable: false
allowed-tools:
  - read_file
  - grep
---

Luettavuuden säilyttäminen ajan myötä

Kirjoita istunnossa pelkkä / nähdäksesi täyden listan saatavilla olevista komennoista, sekä sisäänrakennetuista että henkilökohtaisista, kunkin nimen ja kuvauksen kera. Tämä lista on kojelautasi: jos et löydä omia taitojasi kolmen kuukauden kuluttua, nimeämissi on lipsahtanut epäjohdonmukaisuutta. Verbi-kohde-käytäntö riittää pitämään kaiken yhtenäisenä.

/lint-fix       → toiminto-kohde
/test-generate  → toiminto-kohde
/doc-write      → toiminto-kohde
/db-migrate     → konteksti-toiminto

Frontmatterin kuvaus näkyy tässä automaattisessa täydennyksessä: se on se, mikä muistuttaa sinua kuuden kuukauden päästä täsmällisesti siitä, mitä komento tekee. “Testaustyökalu” ei kerro mitään; pidempi versio kertoo, mikä kehys, kieli ja scope on kyseessä.

# Huono
description: Testaustyökalu

# Hyvä
description: Luo Vitest-yksikkötestejä viedyille TypeScript-funktioille

Keskeiset asiat

  • Jokainen taito, jossa on user-invocable: true, luo automaattisesti slash-komennon
  • Syntaksi: /taidon-nimi valinnaiset-argumentit
  • Argumentit ovat vapaata tekstiä, joka välitetään taidolle kontekstina
  • Yhdistele slash-komentoja luodaksesi päivittäisiä työnkulkuja
  • Kirjoita / luetellaksesi kaikki käytettävissä olevat komennot
  • Nimeä taitosi johdonmukaisesti ja kuvaavasti