Режими по поръчка: Code Review, Deploy, Lint
На тази страница
Урокът е актуализиран на 2 ноември 2026 г. Примерните файлове за агенти вече използват ключове, документирани от Vibe:
instructions(вместоsystem_prompt),active_model(вместоmodel), блокове[tools.<tool>]за одобрения (ключътauto_approveне съществува във файла на агента) и реални имена на инструменти (edit, а неedit_file; няма инструментlist_dir). Напомняне от Урок 3:safetyе визуален индикатор, а не разрешение. Източник: Configuration reference.
Създаване на режими, съобразени с Вашия работен процес
Урокът за унифицираните режими въведе концепцията; сега е време да я изпробвате на практика. Ще изградим три персонализирани режима, които покриват повтарящи се нужди за всеки разработчик: преглед на код, внедряване и линтиране. Всеки от тях представлява .toml файл, разположен в ~/.vibe/agents/, със специфични инструкции. Това, което отличава тези три режима, не са толкова техните инструкции, колкото двойката enabled_tools / [tools.<tool>]: тя решава до какво може да се докосне Vibe и следователно какъв риск поемате; safety е просто визуален етикет.
Рецензент, който не може да счупи нищо
Режимът за преглед на код превръща Vibe в взискателен рецензент, който анализира качеството, сигурността и поддържаемостта на Вашия код. Тъй като той само чете, той е маркиран като safe, а неговите инструменти за четене са настроени на permission = "always": той работи, без да Ви прекъсва и без риск, тъй като няма да бъдат модифицирани файлове. Списъкът с инструменти гарантира това обещание: няма write_file, няма edit, няма bash.
# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "In-depth code review: security, performance, maintainability."
safety = "safe"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
You are a senior developer in code review mode.
Process:
1. Read modified files (git diff or specified files)
2. Analyze each change across 4 axes:
- Security (injection, XSS, CSRF, exposed secrets)
- Performance (N+1, nested loops, memory)
- Maintainability (naming, complexity, duplication)
- Correctness (logic, edge cases, types)
Output format:
## 🔴 Critiques (fix before merge)
## 🟡 Warnings (fix soon)
## 🟢 Suggestions (optional improvements)
For each point: file, line, problem, proposed fix.
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Форматът на изхода, наложен в подкана, не е козметичен: той Ви позволява да сортирате с един поглед какво блокира заявката за сливане (pull request) и какво може да изчака. Стартирате режима и след това му давате или инструкция в свободен формат, или конкретен обхват.
vibe --agent review
# > Analyze modified files in the current branch
# > /review src/api/
Внедряване, което отказва импровизация
Режимът за внедряване (deploy) е точно обратното. Той засяга продукционната среда, затова е маркиран като destructive, а неговите инструменти за запис и bash остават на permission = "ask": всяко действие изисква Вашето валидиране. Цялата стойност на режима се крие във фиксираната последователност на неговата подкана и особено в условията му за спиране. Всяко импровизирано внедряване в петък вечер винаги започва с пропусната стъпка; тук един червен тест спира всичко.
# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Controlled deployment with tests, build, and verification."
safety = "destructive"
active_model = "codestral" # alias declared in config.toml (Lesson 2)
instructions = """
You are in deployment mode. Follow this sequence WITHOUT EXCEPTION:
1. VERIFY — clean git status, no uncommitted files
2. TEST — run the full test suite
3. BUILD — production build
4. VALIDATE — check the build (size, errors, warnings)
5. CONFIRM — ask the user before continuing
6. DEPLOY — run the deployment command
7. VERIFY — confirm the service responds correctly
If a step fails: STOP. Explain the problem and propose a solution.
Never deploy if tests fail.
Never deploy if the build contains critical warnings.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Наличието на ask_user_question в инструментите е от съществено значение: без него стъпка 5 би била празна надежда, тъй като агентът няма технически начин да Ви зададе въпрос.
vibe --agent deploy
# > Follows the sequence test → build → deploy → verification
Автоматично, но дисциплинирано почистване
Между двете се намира режимът за линтиране, който автоматизира форматирането, конвенциите и сортирането на импорти. Той модифицира файлове, така че е neutral, но неговите корекции са механични и обратими чрез Git: пълното одобряване на неговите инструменти (permission = "always") Ви спестява кликането петдесет пъти. Ако списъкът му включва bash, правете това само в изолирана среда или ограничете bash до allowlist само с команди за линтиране. Трите правила в края на подканата са това, което го предпазва от излизане от релсите – агент, оставен на свобода, бързо ще инсталира Biome в проект, който живее перфектно добре с ESLint.
# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Automatic cleanup: lint, format, imports, conventions."
safety = "neutral"
active_model = "codestral" # alias declared in config.toml (Lesson 2)
instructions = """
You are in code cleanup mode.
Tasks:
1. Detect project tools (ESLint, Biome, Prettier, oxlint)
2. Run lint with auto-fix
3. Run formatting
4. Sort and clean up imports
5. Remove detectable dead code
6. Report errors that cannot be fixed automatically
Rules:
- Use tools already configured in the project
- Do not modify tool configuration
- Do not add new tools without asking
"""
enabled_tools = [
"read_file",
"edit",
"bash",
"grep",
]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.bash]
permission = "always" # reserve for isolated environments only
[tools.grep]
permission = "always"
Още два режима и правило за организация
Същата логика важи и за други нужди. Режимът за документация остава neutral, но държи write_file и edit на "ask", защото генерирането на файлове в хранилището заслужава преглед преди запис.
# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Generates and updates technical documentation."
safety = "neutral"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
Generate technical documentation. For each file:
- JSDoc/TSDoc for public functions
- README with usage examples
- Documented environment variables
- API schemas if applicable
"""
enabled_tools = ["read_file", "write_file", "edit", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Режимът за миграция, от друга страна, се присъединява към deploy в категорията destructive: една объркана миграция на схема не може да бъде отменена с git revert, оттук и изискването за системен скрипт за връщане назад (rollback).
# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Handles database and dependency migrations."
safety = "destructive"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
You handle migrations. Absolute rules:
- Always generate a rollback script
- Test the migration on a copy before production
- Document every schema change
"""
enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Накрая, организирайте Вашата директория с агенти така, че критичността да се чете в самата дървовидна структура. Когато превключвате режимите чрез клавиатурата по време на сесия, трябва да знаете без да се замисляте дали режимът, който току-що сте активирали, може да пише на Вашия диск.
~/.vibe/agents/
├── review.toml # safe — read-only
├── lint.toml # neutral — controlled modifications
├── docs.toml # neutral — file generation
├── deploy.toml # destructive — with confirmation
└── migrate.toml # destructive — with confirmation
Ключови изводи
- Всеки режим е
.tomlфайл в~/.vibe/agents/, проектиран за конкретен работен процес - Режимът review има само инструменти за четене, одобрени изцяло: той може само да чете
- Режимът deploy държи
bashи записването на"ask": той иска потвърждение - Режимът lint одобрява своите инструменти за редактиране изцяло: той поправя автоматично
- Настройте
active_modelспоред сложността на задачата instructionsса ключови: бъдете точни относно последователността и правилата