Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izveido prasmi ar SKILL.md

Nodarbība 6 no 14 Atjaunota 2026. gada 2. novembris Augstākais
Šajā lapā
  1. Prasmes: Atkārtoti izmantojami komponenti
  2. SKILL.md uzbūve
  3. YAML frontmatter lauki
  4. SKILL.md saturs
  5. Izveido savu pirmo prasmi
  6. Labākā prakse
  7. Galvenās atziņas

Nodarbība atjaunināta 2026. gada 2. novembrī, pamatojoties uz Prasmes (Skills) lapu Vibe dokumentācijā: prasme ir instrukciju kopums (tā nepievieno rīkus), allowed-tools tiek nolasīts, bet nepiemērots, un ir pievienoti divi lauki (disable-model-invocation, compatibility). Avots: Skills.

Prasmes: Atkārtoti izmantojami komponenti

Agenti definē, kas izpilda uzdevumu. Prasmes definē ko: tās ir atkārtoti izmantojamas instrukciju kopas, kas Mistral Vibe pievieno procedūras un slīpsvītru komandas. Šī atšķirība kļūst konkrēta, kad to pielieto savā komandā — agents atspoguļo personisku darba pieeju, savukārt prasme ietver procedūru, kas visiem jāizpilda vienādi.

Prasme ir direktorijs, kas satur failu SKILL.md ar YAML frontmatter. Šī struktūra ievēro atvērto Agentu Prasmju specifikāciju, padarot prasmes pārnēsājamas un koplietojamas: viena un tā pati mape darbojas tava kolēģa datorā bez papildu pielāgojumiem.

SKILL.md uzbūve

Lūk, pilna prasmes struktūra, ilustrēta ar automatizēta koda pārskata piemēru:

---
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 frontmatter lauki

Lauks name ir prasmes unikālais identifikators. To izmanto, lai prasmi aktivizētu, deaktivizētu un uz to atsauktos konfigurācijās. Šis nosaukums kļūst arī par slīpsvītru komandu, tāpēc ir vērts to saglabāt īsu.

name: code-review

Lauks description (līdz 1024 zīmēm) ir frāze, kas parādās, kad Vibe uzskaita pieejamās prasmes. Raksti to no tāda cilvēka skatpunkta, kurš meklē risinājumu: tai jāļauj izvēlēties starp divām līdzīgām prasmēm, neatverot failus.

description: Performs automated code reviews with quality analysis

Lauks license norāda prasmes licenci, kas kļūst svarīga, tiklīdz to koplieto ārpus savas darbstacijas.

license: MIT

Būla vērtība user-invocable, kas pēc noklusējuma ir true, eksponē prasmi kā slīpsvītru komandu. Iestati to uz false, lai paslēptu to no / izvēlnes: agents joprojām var to automātiski ielādēt, kad uzdevums tam atbilst.

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

Lauks disable-model-invocation, ja iestatīts uz true, neļauj agentam pašam ielādēt prasmi: tā darbojas tikai tad, ja pats ieraksti /prasmes-nosaukums. Paturē to procedūrām, kuras nevienam modelim nevajadzētu aktivizēt bez tavas tiešas piekrišanas, piemēram, izvietošanai (deployment).

disable-model-invocation: true

Divi informatīvi lauki papildina sarakstu: compatibility, kas norāda priekšnosacījumus („Requires git”), un allowed-tools, kas uzskaita rīkus, kurus prasme plāno izmantot. Uzmanieties ar pēdējo: dokumentācija norāda, ka Vibe to nolasa, bet nepiemēro. Prasme var izsaukt jebkuru rīku, ko atļauj aktīvais agents. Lai ierobežotu to, ko prasme var darīt, ierobežo aģenta rīkus un atļaujas (2. un 3. nodarbība).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

SKILL.md saturs

Aiz frontmatter seko faila saturs brīvā formāta Markdown valodā. Tas kalpo gan kā dokumentācija, gan kā prompt: Vibe to nolasa, lai saprastu, kā prasme darbojas un kādā kontekstā to pielietot. Šeit tu apraksti, ko prasme dara, tās darbības soļus, sagaidāmo izvades formātu un lietošanas piemērus. Neskaidrs saturs rada neparedzamu prasmi; precīzs saturs rada prasmi, kas nedēļu no nedēļas dod vienādu rezultātu.

Izveido savu pirmo prasmi

Izveidosim testu ģenerēšanas prasmi. Sāc, izveidojot tās direktoriju:

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

Ievieto tur sekojošo SKILL.md. Ņem vērā, kā saturs atbild uz jautājumiem, kurus Vibe citādi būtu spiests minēt: kuru ietvaru izvēlēties, kā nosaukt blokus, kur rakstīt izvades failu.

---
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.

Tiklīdz fails ir izveidots, prasme ir uzreiz pieejama: nav nepieciešama instalācijas komanda vai restartēšana. Palaid Vibe un izsauc to uz reāla faila.

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

Vibe ielādē prasmi, nolasa tās SKILL.md, lai saprastu sagaidāmo uzvedību, un izpilda uzdevumu ar atļautajiem rīkiem. Velti laiku, lai izlasītu rezultātu: salīdzinot izvadi ar to, ko iedomājies, tu pilnveidosi faila saturu.

Labākā prakse

Ievēro principu „viena prasme vienai funkcijai”. Koda pārskata un testu ģenerēšanas sajaukšana vienā failā rada promptu, kas ir neprecīzs, un neļauj deaktivizēt vienu, nezaudējot otru. Tāpat ierobežo atļautos rīkus tikai līdz tiem, kas prasmei patiešām nepieciešami.

Pārējais ir atkarīgs no rakstīšanas kvalitātes. SKILL.md saturs ir tavs prompts: esi precīzs un iekļauj konkrētus piemērus tam, ko prasme rada — izvades piemērs ir vērtīgāks par trim apraksta rindiņām. Visbeidzot, pārbaudi savu prasmi vairākos gadījumos, tostarp sarežģītā, pirms to koplieto ar komandu.

Galvenās atziņas

  • Prasme ir direktorijs ar failu SKILL.md, kas satur YAML frontmatter
  • Frontmatter definē nosaukumu, aprakstu, atļautos rīkus un izsaukjamību
  • Markdown saturs kalpo gan kā dokumentācija, gan kā prompts priekš Vibe
  • user-invocable: true padara prasmi pieejamu caur slīpsvītru komandu
  • Izveido specializētas prasmes ar minimāli nepieciešamajiem rīkiem