Módok testreszabása: Kódreview, Deploy, Lint
Ezen az oldalon
Lecke frissítve: 2026. november 2. A példa ügynökfájlok most már a Vibe által dokumentált kulcsokat használják:
instructions(nemsystem_prompt),active_model(nemmodel),[tools.<tool>]blokkok a jóváhagyásokhoz (azauto_approvekulcs nem létezik egy ügynökfájlban), és valós eszköznevek (edit, nemedit_file; nincslist_direszköz). Emlékeztető a 3. leckéből: asafetycsak egy vizuális jelző, nem engedély. Forrás: Konfigurációs referencia.
Alkalmazd a munkafolyamatodhoz igazított módokat
Az egyesített módokról szóló lecke bemutatta az elméletet; most itt az idő a gyakorlati alkalmazásra. Három egyedi módot fogunk létrehozni, amelyek minden fejlesztő visszatérő igényeit fedik le: kódreview, telepítés (deploy) és lintelés. Mindegyik egy .toml fájl, amelyet a ~/.vibe/agents/ könyvtárba helyezel el, testreszabott utasításokkal. Ami megkülönbözteti ezt a három módot, az nem annyira az utasításaik, hanem az enabled_tools / [tools.<tool>] páros: ez dönti el, mihez nyúlhat a Vibe, és ezáltal milyen kockázatnak teszed ki magad; a safety csupán egy vizuális címke.
Egy reviewer, ami nem tud semmit elrontani
A kódreview mód egy igényes revieweré alakítja a Vibe-ot, amely elemzi a kódod minőségét, biztonságát és karbantarthatóságát. Mivel csak olvas, safe (biztonságos) jelölést kap, és az olvasóeszközei a permission = "always" értékre vannak állítva: megszakítás nélkül dolgozik, kockázat nélkül, mivel egyetlen fájlt sem módosít. Az eszközlista garantálja ezt: nincs write_file, nincs edit, nincs bash.
# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "Részletes kódreview: biztonság, teljesítmény, karbantarthatóság."
safety = "safe"
active_model = "mistral-medium-3.5" # beépített modell a Vibe-ban
instructions = """
Senior fejlesztő vagy kódreview módban.
Folyamat:
1. Olvasd el a módosított fájlokat (git diff vagy megadott fájlok)
2. Elemezd az egyes változtatásokat 4 tengely mentén:
- Biztonság (injekció, XSS, CSRF, kiszivárgott titkok)
- Teljesítmény (N+1, beágyazott ciklusok, memória)
- Karbantarthatóság (elnevezés, komplexitás, duplikáció)
- Helyesség (logika, szélsőértékek, típusok)
Kimeneti formátum:
## 🔴 Kritika (merge előtt javítandó)
## 🟡 Figyelmeztetés (hamarosan javítandó)
## 🟢 Javaslatok (opcionális fejlesztések)
Minden pontnál: fájl, sor, probléma, javasolt javítás.
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
A promptban kikényszerített kimeneti formátum nem csak kozmetika: lehetővé teszi, hogy első pillantásra eldöntsd, mi akadályozza meg a pull requestet, és mi várhat. Elindítod a módot, majd adsz neki vagy egy szabad formátumú utasítást, vagy egy konkrét hatókört.
vibe --agent review
# > Elemezze a jelenlegi ágon módosított fájlokat
# > /review src/api/
Egy telepítés, ami nem szeret improvizálni
A deploy mód pontosan az ellenkezője. Éles környezetet érint, ezért destructive (romboló) jelölést kap, az író- és bash eszközei pedig a permission = "ask" értéken maradnak: minden művelethez jóváhagyásod szükséges. A mód teljes értéke a promptjának rögzített szekvenciájában rejlik, és különösen a leállítási feltételeiben. Egy rögtönzött péntek esti telepítés mindig egy kihagyott lépéssel kezdődik; itt egy piros teszt mindent leállít.
# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Vezérelt telepítés tesztekkel, build-del és ellenőrzéssel."
safety = "destructive"
active_model = "codestral" # alias deklarálva a config.toml-ban (2. lecke)
instructions = """
Telepítési módban vagy. Kövesd ezt a szekvenciát KIVÉTEL NÉLKÜL:
1. ELLENŐRZÉS — tiszta git státusz, nincsenek nem commitolt fájlok
2. TESZT — futtasd a teljes tesztsort
3. BUILD — éles build
4. VALIDÁLÁS — ellenőrizd a buildet (méret, hibák, figyelmeztetések)
5. MEGERŐSÍTÉS — kérdezd meg a felhasználót a folytatás előtt
6. DEPLOY — futtasd a telepítési parancsot
7. ELLENŐRZÉS — győződj meg róla, hogy a szolgáltatás helyesen válaszol
Ha egy lépés sikertelen: ÁLLJ MEG. Magyarázd el a problémát és javasolj megoldást.
Soha ne telepíts, ha a tesztek sikertelenek.
Soha ne telepíts, ha a build kritikus figyelmeztetéseket tartalmaz.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Az ask_user_question jelenléte az eszközök között elengedhetetlen: enélkül az 5. lépés csak vágyálom lenne, mivel az ügynöknek nem lenne technikai lehetősége kérdést intézni hozzád.
vibe --agent deploy
# > Követi a szekvenciát: teszt → build → deploy → ellenőrzés
Automatikus, de fegyelmezett tisztítás
A kettő között helyezkedik el a lint mód, amely automatizálja a formázást, a konvenciókat és az importok rendezését. Módosít fájlokat, ezért neutral (semleges), de javításai mechanikusak és Git segítségével visszafordíthatók: ha az eszközeit eleve jóváhagyod (permission = "always"), megspórolod az ötvenszeri kattintást. Ha a listája tartalmazza a bash-t, ezt csak izolált környezetben tedd, vagy korlátozd a bash-t kizárólag lint parancsok allowlist-jére. A prompt végén található három szabály tartja kordában: egy szabadon futó ügynök gyorsan telepítené a Biome-ot egy olyan projektbe, amely tökéletesen elvan az ESLinttel is.
# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Automatikus tisztítás: lint, formázás, importok, konvenciók."
safety = "neutral"
active_model = "codestral" # alias deklarálva a config.toml-ban (2. lecke)
instructions = """
Kódtisztítási módban vagy.
Feladatok:
1. Észleld a projekt eszközeit (ESLint, Biome, Prettier, oxlint)
2. Futtasd a lintet auto-fixszel
3. Futtasd a formázást
4. Rendezd és tisztítsd meg az importokat
5. Távolítsd el az észlelhető halott kódot
6. Jelentsd azokat a hibákat, amelyek nem javíthatók automatikusan
Szabályok:
- Használd a projektben már konfigurált eszközöket
- Ne módosítsd az eszközök konfigurációját
- Ne adj hozzá új eszközöket kérdezés nélkül
"""
enabled_tools = [
"read_file",
"edit",
"bash",
"grep",
]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.bash]
permission = "always" # csak izolált környezetekre fenntartva
[tools.grep]
permission = "always"
Még két mód és egy szervezési szabály
Ugyanez az érvelés vonatkozik más igényekre is. Egy dokumentációs mód neutral marad, de a write_file és edit eszközöket "ask" értéken tartja, mert a fájlok generálása egy tárolóban megérdemel egy pillantást írás előtt.
# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Technikai dokumentáció generálása és frissítése."
safety = "neutral"
active_model = "mistral-medium-3.5" # beépített modell a Vibe-ban
instructions = """
Technikai dokumentáció generálása. Minden fájlhoz:
- JSDoc/TSDoc a nyilvános függvényekhez
- README használati példákkal
- Dokumentált környezeti változók
- API sémák, ha alkalmazható
"""
enabled_tools = ["read_file", "write_file", "edit", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Egy migrációs mód eközben csatlakozik a deployhoz a destructive kategóriában: egy elrontott schema migrációt nem lehet egy git revert-tel visszafordítani, ezért szükséges a szisztematikus rollback szkript.
# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Adatbázis- és függőségmigrációk kezelése."
safety = "destructive"
active_model = "mistral-medium-3.5" # beépített modell a Vibe-ban
instructions = """
Migrációkat kezelsz. Abszolút szabályok:
- Mindig generálj rollback szkriptet
- Teszteld a migrációt egy másolaton élesítés előtt
- Dokumentálj minden schema változtatást
"""
enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Végül rendezd el az ügynökök könyvtárát úgy, hogy a kritikalitás maga a faszerkezetből is olvasható legyen. Amikor billentyűzettel váltasz módokat munkamenet közben, gondolkodás nélkül tudnod kell, hogy az imént aktivált mód írhat-e a lemezedre.
~/.vibe/agents/
├── review.toml # safe — csak olvasás
├── lint.toml # neutral — vezérelt módosítások
├── docs.toml # neutral — fájlgenerálás
├── deploy.toml # destructive — megerősítéssel
└── migrate.toml # destructive — megerősítéssel
Főbb megállapítások
- Minden mód egy
.tomlfájl a~/.vibe/agents/könyvtárban, amelyet egy adott munkafolyamatra terveztek - A review módnak csak olvasóeszközei vannak, eleve jóváhagyva: csak olvasni tud
- A deploy mód a
bash-t és az írást"ask"értéken tartja: megerősítést kér - A lint mód eleve jóváhagyja a szerkesztőeszközeit: automatikusan javít
- A
active_model-t a feladat összetettsége alapján állítsd be - Az
instructionsa kulcs: légy precíz a szekvenciával és a szabályokkal kapcsolatban