Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Sukurk įgūdį naudodamas SKILL.md

Paskaita 6 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Pažengusiems
Šiame puslapyje
  1. Įgūdžiai: pakartotinai naudojami komponentai
  2. SKILL.md anatomija
  3. YAML antraštės laukai
  4. SKILL.md turinys
  5. Sukurk savo pirmąjį įgūdį
  6. Geriausios praktikos
  7. Svarbiausi punktai

Pamoka atnaujinta 2026 m. lapkričio 2 d. remiantis Skills puslapiu Vibe dokumentacijoje: įgūdis yra instrukcijų rinkinys (jis neprideda įrankių), allowed-tools yra nuskomas, tačiau neprivalomas, ir buvo pridėti du laukai (disable-model-invocability, compatibility). Šaltinis: Skills.

Įgūdžiai: pakartotinai naudojami komponentai

Agentai apibrėžia, kas vykdo užduotį. Įgūdžiai apibrėžia ką: tai pakartotinai naudojamų instrukcijų rinkiniai, kurie prideda procedūrų ir komandų su pasviruoju brūkšniu į Mistral Vibe. Skirtumas tampa aiškus, kai jį pritaikai savo komandai – agentas atspindi asmeninę darbo laikyseną, o įgūdis įkapsuliuoja procedūrą, kurią visi turi vykdyti vienodai.

Įgūdis yra katalogas, kuriame yra SKILL.md failas su YAML antrašte. Ši struktūra laikosi atviros Agent Skills specifikacijos, todėl įgūdžiai yra perkeliami ir bendrinami: tas pats aplankas veikia tavo kolegos kompiuteryje be jokių pakeitimų.

SKILL.md anatomija

Štai pilna įgūdžio struktūra, iliustruota automatizuoto kodo peržiūros pavyzdžiu:

---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
  - read_file
  - grep
  - ask_user_question
---

# Code Review Skill

This skill analyzes source code quality by checking:

1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)

## Usage

Run `/code-review` followed by the path or description of the code to analyze.

## Output format

The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement

YAML antraštės laukai

Laukas name yra unikalus įgūdžio identifikatorius. Jis naudojamas įgūdžiui įjungti, išjungti ir nurodyti konfigūracijose. Šis pavadinimas taip pat tampa komanda su pasviruoju brūkšniu, todėl verta jį laikyti trumpą.

name: code-review

description, iki 1024 simbolių, yra frazė, kuri atsiranda, kai Vibe išvardija galimus įgūdžius. Rašyk ją iš žmogaus, ieškančio sprendimo, perspektyvos: ji turi leisti pasirinkti tarp dviejų panašių įgūdžių neatidarius failų.

description: Performs automated code reviews with quality analysis

Laukas license nurodo įgūdžio licenciją, kuri tampa svarbi, kai pradedi jį bendrinti už savo darbo stoties ribų.

license: MIT

Būlio tipo laukas user-invocable, pagal nutylėjimą true, pateikia įgūdį kaip komandą su pasviruoju brūkšniu. Nustatyk jį į false, kad paslėptum iš / meniu: agentas vis tiek gali jį automatiškai įkelti, kai užduotis tam tinka.

user-invocable: true   # Accessible via /code-review
user-invocable: false  # Hidden from / menu, agent can still load it

Laukas disable-model-invocation, nustatytas į true, neleidžia agentui savarankiškai įkelti įgūdžio: jis vykdomas tik tada, kai pats įvedi /skill-name. Palik tai procedūroms, kurių joks modelis neturėtų inicijuoti be tavo aiškaus sutikimo, pavyzdžiui, diegimui.

disable-model-invocation: true

Du informaciniai laukai užbaigia sąrašą: compatibility, kuris nurodo būtinus reikalavimus („Requires git“), ir allowed-tools, kuris išvardija įrankius, kuriuos įgūdis ketina naudoti. Būk atsargus su pastaruoju: dokumentacija nurodo, kad Vibe jį nusko, tačiau neprivalo jo laikytis. Įgūdis gali kviesti bet kurį įrankį, kurį leidžia aktyvus agentas. Norėdamas apriboti, ką įgūdis gali daryti, apribok agento įrankius ir leidimus (2 ir 3 pamokos).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

SKILL.md turinys

Po antrašte, failo turinys yra laisvos formos Markdown. Jis tarnauja ir kaip dokumentacija, ir kaip promptas: Vibe jį skaito, kad suprastų, kaip veikia įgūdis ir kokiu kontekstu jį taikyti. Čia aprašai, ką įgūdis daro, jo veiksmų eigą, numatomą išvesties formatą ir naudojimo pavyzdžius. Neaiškus turinys sukuria nenuspėjamą įgūdį; tikslus turinys sukuria įgūdį, kuris savaitę po savaitės duoda tą patį rezultatą.

Sukurk savo pirmąjį įgūdį

Sukurkime testų generavimo įgūdį. Pradėk sukurdamas jo katalogą:

mkdir -p ~/.vibe/skills/test-generator

Įdėk šį SKILL.md viduje. Atkreipk dėmesį, kaip turinys atsako į klausimus, kuriuos Vibe kitaip turėtų spėlioti: kurią sistemą pasirinkti, kaip pavadinti blokus, kur rašyti išvesties failą.

---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
  - read_file
  - write_file
  - grep
---

# Test Generator

Generates comprehensive unit tests for
TypeScript and JavaScript functions.

## Process

1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
   - Happy path test
   - Test with empty/null inputs
   - Edge case tests
   - Expected error tests
4. Write tests to an adjacent `.test.ts` file

## Conventions

- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)

## Example

For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.

Kai failas sukurtas, įgūdis iškart prieinamas: nereikia jokios diegimo komandos ar paleidimo iš naujo. Paleisk Vibe ir iškviesk jį realiame faile.

vibe
# > /test-generator src/utils/math.ts

Vibe įkelia įgūdį, nusko jo SKILL.md, kad suprastų numatomą elgseną, ir vykdo užduotį naudodamas autorizuotus įrankius. Skirk laiko perskaityti rezultatą: palyginęs išvestį su tuo, ką įsivaizdavai, patobulinsi failo turinį.

Geriausios praktikos

Laikykitės vieno įgūdžio vienai funkcijai. Kodų peržiūros ir testų generavimo maišymas viename faile sukuria promptą, kuris blaškosi, ir neleidžia išjungti vienos funkcijos neprarasdamas kitos. Panašiai, apribok autorizuotus įrankius tik tais, kurių įgūdžiui iš tikrųjų reikia.

Visa kita priklauso nuo rašymo kokybės. SKILL.md turinys yra tavo promptas: būk tikslus ir įtrauk konkrečius pavyzdžius, ką įgūdis gamina – išvesties pavyzdys vertingesnis už tris aprašymo eilutes. Galiausiai, prieš dalindamasis su komanda, išbandyk savo įgūdį keliais atvejais, įskaitant sudėtingus.

Svarbiausi punktai

  • Įgūdis yra katalogas su SKILL.md failu, turinčiu YAML antraštę
  • Antraštė apibrėžia pavadinimą, aprašymą, leidžiamus įrankius ir galimybę iškviesti
  • Markdown turinys tarnauja ir kaip dokumentacija, ir kaip Vibe promptas
  • user-invocable: true padaro įgūdį pasiekiamą per komandą su pasviruoju brūkšniu
  • Kurk specializuotus įgūdžius naudodamas minimalų būtiną įrankių kiekį