Salt la conținutul principal
Română— Alege o limbă
Meniu

Moduri personalizate: Revizuire cod, Deploy, Lint

Lecția 9 din 14 Actualizată 2 noiembrie 2026 Avansat
Pe această pagină
  1. Crearea de moduri adaptate fluxului dumneavoastră de lucru
  2. Un recenzor care nu poate strica nimic
  3. O implementare care refuză improvizația
  4. Curățenie automată, dar disciplinată
  5. Încă două moduri și o regulă de organizare
  6. Puncte cheie

Lecție actualizată la 2 noiembrie 2026. Fișierele exemplu de agenți folosesc acum cheile documentate de Vibe: instructions (nu system_prompt), active_model (nu model), blocuri [tools.<tool>] pentru aprobări (cheia auto_approve nu există într-un fișier de agent) și nume reale de instrumente (edit, nu edit_file; fără instrumentul list_dir). Reamintire din Lecția 3: safety este un indicator vizual, nu o permisiune. Sursă: Referință de configurare.

Crearea de moduri adaptate fluxului dumneavoastră de lucru

Lecția despre modurile unificate a introdus conceptul; acum este momentul să îl puneți în practică. Vom construi trei moduri personalizate care acoperă nevoile recurente ale fiecărui dezvoltator: revizuirea codului, implementarea (deploy) și verificarea stilului (linting). Fiecare este un fișier .toml plasat în ~/.vibe/agents/, cu instrucțiuni specifice. Ceea ce distinge aceste trei moduri nu sunt atât instrucțiunile, cât perechea enabled_tools / [tools.<tool>]: aceasta decide ce poate atinge Vibe și, prin urmare, ce risc asumați; safety este doar eticheta vizuală.

Un recenzor care nu poate strica nimic

Modul de revizuire a codului transformă Vibe într-un recenzor exigent care analizează calitatea, securitatea și mentenabilitatea codului dumneavoastră. Deoarece doar citește, este marcat ca safe, iar instrumentele sale de citire sunt setate la permission = "always": funcționează fără a vă întrerupe și fără risc, deoarece niciun fișier nu va fi modificat. Lista de instrumente respectă această promisiune: fără write_file, fără edit, fără 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"

Formatul de ieșire impus în prompt nu este cosmetic: vă permite să sortați dintr-o privire ce blochează un pull request și ce poate aștepta. Lansați modul, apoi îi oferiți fie o instrucțiune liberă, fie un scop specific.

vibe --agent review
# > Analyze modified files in the current branch
# > /review src/api/

O implementare care refuză improvizația

Modul de deploy este exact opusul. Atinge producția, deci este marcat ca destructive, iar instrumentele sale de scriere și bash rămân la permission = "ask": fiecare acțiune necesită validarea dumneavoastră. Întreaga valoare a modului constă în secvența fixă a promptului său și, în special, în condițiile sale de oprire. O implementare improvizată într-o vineri seara începe întotdeauna cu un pas sărit; aici, un test eșuat oprește totul.

# ~/.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"

Prezența lui ask_user_question în lista de instrumente este esențială: fără el, pasul 5 ar fi o simplă dorință, deoarece agentul nu ar avea nicio modalitate tehnică de a vă interpela.

vibe --agent deploy
# > Follows the sequence test → build → deploy → verification

Curățenie automată, dar disciplinată

Între cele două se află modul lint, care automatizează formatarea, convențiile și sortarea importurilor. Modifică fișiere, deci este neutral, dar corecțiile sale sunt mecanice și reversibile prin Git: aprobarea instrumentelor sale direct (permission = "always") vă scutește de a face clic de cincizeci de ori. Dacă lista sa include bash, faceți acest lucru doar într-un mediu izolat sau limitați bash la o allowlist de comenzi lint. Cele trei reguli de la sfârșitul promptului sunt cele care îl împiedică să o ia razna – un agent care rulează liber va instala rapid Biome într-un proiect care trăiește perfect bine cu 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"

Încă două moduri și o regulă de organizare

Același raționament se aplică și altor nevoi. Un mod de documentație rămâne neutral, dar menține write_file și edit la "ask", deoarece generarea de fișiere într-un repository merită o privire înainte de scriere.

# ~/.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"

Un mod de migrare, în schimb, se alătură lui deploy în categoria destructive: o migrare de schemă ratată nu poate fi anulată cu un git revert, de unde și necesitatea unui script de rollback sistematic.

# ~/.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"

În final, organizați-vă directorul de agenți astfel încât criticitatea să fie lizibilă chiar în structura arborelui. Când comutați modurile prin tastatură în timpul unei sesiuni, trebuie să știți fără să gândiți dacă modul pe care tocmai l-ați activat poate scrie pe discul dumneavoastră.

~/.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

Puncte cheie

  • Fiecare mod este un fișier .toml în ~/.vibe/agents/ conceput pentru un flux de lucru specific
  • Modul review are doar instrumente de citire, aprobate direct: poate doar să citească
  • Modul deploy menține bash și scrierea la "ask": cere confirmare
  • Modul lint aprobă direct instrumentele sale de editare: repară automat
  • Ajustați active_model în funcție de complexitatea sarcinii
  • instructions sunt esențiale: fiți preciși privind secvența și regulile