Sjednocené režimy: kombinace nástrojů, oprávnění a chování
Na této stránce
Lekce aktualizována 2. listopadu 2026. Příkladové soubory agentů nyní používají klíče dokumentované systémem Vibe:
instructions(místosystem_prompt),active_model(místomodel), bloky[tools.<nástroj>]pro schvalování (klíčauto_approvev souboru agenta neexistuje) a skutečné názvy nástrojů (edit, nikolivedit_file; žádný nástrojlist_dir). Připomínka z lekce 3:safetyje pouze vizuální indikátor, nikoliv oprávnění. Zdroj: Odkaz na konfiguraci.
Koncept sjednocených režimů
Vlastní agenti, které jsme probírali v předchozích lekcích, definují statický profil: model, sadu nástrojů a úroveň bezpečnosti. Sjednocené režimy jdou ještě dál tím, že kombinují více dimenzí do jedné ucelené konfigurace, kterou aktivuješ jediným gestem. Sjednocený režim sdružuje autorizované nástroje, specifická oprávnění, chování řízené systémovým promptem, pravidla pro automatické schvalování a kontextová omezení.
Hodnota tohoto přístupu je zřejmá, když se během dne několikrát změní charakter tvé práce. Bez sjednocených režimů bys musel pokaždé při změně kontextu žonglovat s různými nastaveními: přecházíš od code review k nasazení a musíš měnit agenty, upravovat oprávnění a ladit prompt. Sjednocený režim zapouzdří vše do jednoho profilu, který aktivuješ při spuštění nebo uprostřed relace.
# Aktivovat režim "deploy"
vibe --agent deploy-mode
# Přepnout do režimu "review"
# Shift+Tab → vybrat review-mode
Struktura sjednoceného režimu
Technicky vzato je sjednocený režim vlastním agentem; rozdíl oproti klasickému agentovi je koncepční. Soubor .toml již nenavrhuješ jako „asistenta, který umí X“, ale jako kompletní pracovní kontext: co smíš v této fázi projektu dělat, s jakou mírou opatrnosti a v jaké formě se ti mají vracet výsledky.
Níže uvedený režim pro review to ilustruje nejnázorněji. Je pouze pro čtení, takže je bez rizika automaticky schvalován a jeho prompt vynucuje formát reportu, který můžeš přímo vložit do pull requestu.
# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Režim code review: pouze pro čtení, hloubková analýza, návrhy."
safety = "safe"
active_model = "mistral-medium-3.5" # model vestavěný ve Vibe
instructions = """
Jsi v režimu code review.
Cíl: analyzovat kvalitu kódu, bezpečnost a udržovatelnost.
Pravidla:
- Nikdy neměň soubory
- Vytvoř strukturovaný report (kritické problémy, varování, návrhy)
- Cituj affected řádky kódu s čísly řádků
- Navrhuj opravy jako diffy
Formát výstupu: Markdown se sekcemi Critical / Warning / Suggestion
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Režim deploy je jeho přesným opakem a tento kontrast je záměrný. Obsahuje bash, takže může něco rozbít, ale jeho oprávnění ask pro write_file a bash tě udržují ve smyčce rozhodování a jeho prompt popisuje přísnou sekvenci, kterou musí agent dodržet od začátku do konce.
# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Režim nasazení: build, test, deploy s validací v každém kroku."
safety = "destructive"
active_model = "codestral" # alias deklarovaný v config.toml (lekce 2)
instructions = """
Jsi v režimu nasazení.
Povinná sekvence:
1. Ověř, že všechny testy projdou
2. Sestav projekt (build)
3. Validuj build (žádné chyby, žádná varování)
4. Před skutečným nasazením vyžádej potvrzení
5. Nasadit
6. Ověř, že služba odpovídá
Nikdy nenasazuj, pokud testy selžou.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Návrh doplňkových režimů
Myšlenkou je vytvořit sadu režimů, které pokryjí celý tvůj vývojový cyklus, od objevování až po opravování. V cestě vede režim Exploration: pouze pro čtení a automaticky schvalovaný ti pomůže pochopit repozitář, než do něj začneš zasahovat.
display_name = "Explore Mode"
safety = "safe"
instructions = """Prozkoumej codebase, identifikuj architekturu, vzory a závislosti."""
enabled_tools = ["read_file", "grep",]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Následuje režim Dev, ve kterém strávíš většinu času. Píše a spouští příkazy – například pro běh testů – ale žádá o tvé schválení a jeho prompt váže každou změnu na psaní testů.
display_name = "Dev Mode"
safety = "neutral"
instructions = """Implementuj požadované funkce. Ke každé změně napiš testy."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
[tools.bash]
permission = "ask"
Nakonec je tu režim Fix, který je záměrně úzký. Žádné write_file, pouze edit: agent upravuje existující kód bez vytváření nových souborů, což mu brání v „refaktorování cestou“ u bugu, který jsi po něm chtěl jen opravit. Protože je takto omezen, můžeme jej bezpečně automaticky schvalovat.
display_name = "Fix Mode"
safety = "neutral"
instructions = """Oprav nahlášené bugy. Minimalizuj změny. Dotýkej se pouze affected kódu."""
enabled_tools = ["read_file", "edit", "grep"]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Přepínání mezi režimy a jejich organizace
V interaktivní relaci cykluješ mezi režimy pomocí Shift+Tab: Vibe zobrazí seznam všech tvých agentů, vestavěných i vlastních, včetně jejich popisů – zde se vyplatí pečlivé popisování z předchozí lekce. Z příkazového řádku spustíš přímo v daném režimu, nebo si prohlédneš obsah adresáře agentů.
# Spustit přímo v režimu
vibe --agent review-mode
# Vypsat dostupné agenty
ls ~/.vibe/agents/
Nakonec přijmi jasnou konvenci pojmenování. Přípona -mode okamžitě odliší tvé pracovní kontexty od více ad hoc utility agentů a abecední pořadí v adresáři zůstane čitelné i po desítkách souborů.
~/.vibe/agents/
├── review-mode.toml # Code review
├── deploy-mode.toml # Nasazení
├── dev-mode.toml # Vývoj
├── fix-mode.toml # Opravy
├── explore-mode.toml # Průzkum
└── doc-mode.toml # Dokumentace
Klíčové poznatky
- Sjednocený režim je vlastní agent navržený jako kompletní pracovní kontext
- Kombinuje nástroje, oprávnění, systémový prompt a model v jedné konfiguraci
- Vytvářej doplňkové režimy, které pokryjí tvůj vývojový cyklus
Shift+Tabti umožňuje přepínat mezi režimy v reálném čase- Pojmenovávej soubory konzistentně, abys je snadno našel
- Každý režim musí mít jasný cíl a odpovídající oprávnění