Načini po meri: pregled kode, uvedba, lintanje
Na tej strani
Lekcija posodobljena 2. novembra 2026. Primerne datoteke agentov zdaj uporabljajo ključe, ki jih dokumentira Vibe:
instructions(nesystem_prompt),active_model(nemodel), bloke[tools.<tool>]za odobritve (ključauto_approvev datoteki agenta ne obstaja) in prava imena orodij (edit, needit_file; orodjelist_dirne obstaja). Opomnik iz lekcije 3:safetyje vizualni indikator, ne dovoljenje. Vir: Referenca za konfiguracijo.
Ustvari načine, prilagojene tvojemu delovnemu toku
Lekcija o enotnih načinih je predstavila koncept; zdaj je čas, da ga preizkusiš v praksi. Zgradili bomo tri načine po meri, ki pokrivajo ponavljajoče se potrebe vsakega razvijalca: pregled kode, uvedbo in lintanje. Vsak je datoteka .toml, postavljena v ~/.vibe/agents/, s prilagojenimi navodili. Tistega, kar ločuje te tri načine, niso toliko njihova navodila, temveč par enabled_tools / [tools.<tool>]: ta določa, česa se lahko Vibe dotakne in s tem kakšno tveganje prevzameš; safety je zgolj vizualna oznaka.
Pregledovalec, ki ne more ničesar pokvariti
Način za pregled kode spremeni Vibe v zahtevnega pregledovalca, ki analizira kakovost, varnost in vzdrževljivost tvoje kode. Ker samo bere, je označen kot safe, njegova orodja za branje pa so nastavljena na permission = "always": deluje brez prekinjanja tvojega dela in brez tveganja, saj nobena datoteka ne bo spremenjena. Seznam orodij to obljubo tudi izpolnjuje: brez write_file, brez edit, brez bash.
# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "Poglobljen pregled kode: varnost, zmogljivost, vzdrževljivost."
safety = "safe"
active_model = "mistral-medium-3.5" # model, vgrajen v Vibe
instructions = """
Si senior razvijalec v načinu za pregled kode.
Postopek:
1. Preberi spremenjene datoteke (git diff ali določene datoteke)
2. Analiziraj vsako spremembo po 4 oseh:
- Varnost (injekcije, XSS, CSRF, razkrita gesla)
- Zmogljivost (N+1, gnezdenje zank, pomnilnik)
- Vzdrževljivost (poimenovanje, kompleksnost, podvajanje)
- Pravilnost (logika, robni primeri, tipi)
Oblika izpisa:
## 🔴 Kritike (popravi pred združitvijo)
## 🟡 Opozorila (popravi kmalu)
## 🟢 Predlogi (izbirne izboljšave)
Za vsako točko: datoteka, vrstica, težava, predlagana popravila.
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Oblika izpisa, vsiljena v pozivu, ni kozmetična: omogoča ti, da na prvi pogled razvrstiš, kaj blokira zahtevo za združitev (pull request) in kaj lahko počaka. Način zaženeš, nato pa mu podaš bodisi navodilo v prosti obliki bodisi določen obseg.
vibe --agent review
# > Analiziraj spremenjene datoteke v trenutni veji
# > /review src/api/
Uvedba, ki noče improvizirati
Način za uvedbo (deploy) je popolno nasprotje. Dotika se produkcijskega okolja, zato je označen kot destructive, njegova orodja za pisanje in bash pa ostanejo na permission = "ask": vsako dejanje zahteva tvojo potrditev. Celotna vrednost tega načina leži v fiksnem zaporedju njegovega poziva in še posebej v pogojih za zaustavitev. Improvizirana uvedba petek zvečer se vedno začne s preskočenim korakom; tukaj rdeči test ustavi vse.
# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Nadzorovana uvedba s testi, gradnjo in preverjanjem."
safety = "destructive"
active_model = "codestral" # vzdevek, deklariran v config.toml (lekcija 2)
instructions = """
Si v načinu za uvedbo. Sledi temu zaporedju BREZ IZJEM:
1. PREVERI — čisto stanje git, ni nepotrjenih datotek
2. TESTIRAJ — zaženi celoten nabor testov
3. GRADI — produkcijska gradnja
4. POTRDI — preveri gradnjo (velikost, napake, opozorila)
5. POTRDI UPORABNIKA — vprašaj uporabnika pred nadaljevanjem
6. UVEDI — zaženi ukaz za uvedbo
7. PREVERI — potrdi, da storitev pravilno odgovarja
Če korak spodleti: USTAVI. Pojasni težavo in predlagaj rešitev.
Nikoli ne uvajaj, če testi ne uspejo.
Nikoli ne uvajaj, če gradnja vsebuje kritična opozorila.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Prisotnost ask_user_question v orodjih je bistvena: brez nje bi bil 5. korak jalovo upanje, saj agent ne bi imel tehnične možnosti, da te kaj vpraša.
vibe --agent deploy
# > Sledi zaporedju test → gradnja → uvedba → preverjanje
Samodejno, a disciplinirano čiščenje
Med obema se nahaja način za lintanje, ki avtomatizira oblikovanje, konvencije in razvrščanje uvozov. Spreminja datoteke, zato je neutral, vendar so njegovi popravki mehanski in reverzibilni prek Gita: popolna odobritev njegovih orodij (permission = "always") te reši pred petdesetimi kliki. Če njegov seznam vključuje bash, to stori le v izoliranem okolju ali omeji bash na allowlist samo za ukaze lintanja. Tri pravila na koncu poziva so tista, ki preprečujejo, da bi streljal mimo cilja — agent, ki teče prosto, bo hitro namestil Biome v projekt, ki popolnoma dobro deluje z ESLintom.
# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Samodejno čiščenje: lint, formatiranje, uvozi, konvencije."
safety = "neutral"
active_model = "codestral" # vzdevek, deklariran v config.toml (lekcija 2)
instructions = """
Si v načinu za čiščenje kode.
Naloge:
1. Zaznaj orodja v projektu (ESLint, Biome, Prettier, oxlint)
2. Zaženi lint s samodejnim popravljanjem
3. Zaženi formatiranje
4. Razvrsti in počisti uvoze
5. Odstrani zaznano mrtvo kodo
6. Poročaj o napakah, ki jih ni mogoče samodejno popraviti
Pravila:
- Uporabi orodja, ki so že konfigurirana v projektu
- Ne spreminjaj konfiguracije orodij
- Ne dodajaj novih orodij brez vprašanja
"""
enabled_tools = [
"read_file",
"edit",
"bash",
"grep",
]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.bash]
permission = "always" # rezervirano samo za izolirana okolja
[tools.grep]
permission = "always"
Še dva načina in pravilo organizacije
Enako razmišljanje velja za druge potrebe. Način za dokumentacijo ostane neutral, vendar ohranja write_file in edit na "ask", saj si ustvarjanje datotek v repozitoriju zasluži pogled pred zapisom.
# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Ustvarja in posodablja tehnično dokumentacijo."
safety = "neutral"
active_model = "mistral-medium-3.5" # model, vgrajen v Vibe
instructions = """
Ustvari tehnično dokumentacijo. Za vsako datoteko:
- JSDoc/TSDoc za javne funkcije
- README s primeri uporabe
- Dokumentirane spremenljivke okolja
- Sheme API-ja, če je primerno
"""
enabled_tools = ["read_file", "write_file", "edit", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Način za migracije se medtem pridruži uvedbi v kategoriji destructive: pokvarjene migracije sheme ni mogoče razveljaviti z git revert, zato je potreben sistematičen skript za povrnitev v prejšnje stanje (rollback).
# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Upravlja migracije baz podatkov in odvisnosti."
safety = "destructive"
active_model = "mistral-medium-3.5" # model, vgrajen v Vibe
instructions = """
Upravljaš migracije. Absolutna pravila:
- Vedno ustvari skript za povrnitev (rollback)
- Testiraj migracijo na kopiji pred produkcijo
- Dokumentiraj vsako spremembo sheme
"""
enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Končno, organiziraj svoj imenik agentov tako, da je kritičnost razvidna že iz same strukture drevesa. Ko med sejo prek tipkovnice preklopiš načine, moraš brez razmišljanja vedeti, ali način, ki si ga pravkar aktiviral, lahko piše na tvoj disk.
~/.vibe/agents/
├── review.toml # safe — samo branje
├── lint.toml # neutral — nadzorovane spremembe
├── docs.toml # neutral — ustvarjanje datotek
├── deploy.toml # destructive — s potrditvijo
└── migrate.toml # destructive — s potrditvijo
Ključne ugotovitve
- Vsak način je datoteka
.tomlv~/.vibe/agents/, zasnovana za specifičen delovni tok - Način review ima samo orodja za branje, popolnoma odobrena: lahko samo bere
- Način deploy ohranja
bashin pisanje na"ask": zahteva potrditev - Način lint popolnoma odobri svoja orodja za urejanje: samodejno popravlja
- Prilagodi
active_modelglede na kompleksnost naloge instructionsso ključne: bodi natančen glede zaporedja in pravil