Премини към основното съдържание
Български— Изберете език
Меню

Режими по поръчка: Code Review, Deploy, Lint

Урок 9 от 14 Обновен 2 ноември 2026 г. Напреднало
На тази страница
  1. Създаване на режими, съобразени с Вашия работен процес
  2. Рецензент, който не може да счупи нищо
  3. Внедряване, което отказва импровизация
  4. Автоматично, но дисциплинирано почистване
  5. Още два режима и правило за организация
  6. Ключови изводи

Урокът е актуализиран на 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 са ключови: бъдете точни относно последователността и правилата