Moduri personalizate: Revizuire cod, Deploy, Lint
Pe această pagină
Lecție actualizată la 2 noiembrie 2026. Fișierele exemplu de agenți folosesc acum cheile documentate de Vibe:
instructions(nusystem_prompt),active_model(numodel), blocuri[tools.<tool>]pentru aprobări (cheiaauto_approvenu există într-un fișier de agent) și nume reale de instrumente (edit, nuedit_file; fără instrumentullist_dir). Reamintire din Lecția 3:safetyeste 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 instructionssunt esențiale: fiți preciși privind secvența și regulile