Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Modalitajiet Personalizzati: Code Review, Deploy, Lint

Lezzjoni 9 / 14 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Oħloq modalitajiet adattati għax-xogħol tiegħek
  2. Reviżur li ma jista’ jkisser xejn
  3. Dispjegament li jirrifjuta li jimprovviża
  4. Tindifa awtomatika iżda dixxiplinata
  5. Żewġ modalitajiet oħra, u regola ta’ organizzazzjoni
  6. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru 2026. Il-fajls tal-aġenti issa jużaw iċ-ċwievet iddokumentati minn Vibe: instructions (mhux system_prompt), active_model (mhux model), blokki [tools.<tool>] għall-approvazzjonijiet (iċ-ċavetta auto_approve ma teżistix f’fajl tal-aġent), u ismijiet reali tal-għodod (edit, mhux edit_file; l-ebda għodda list_dir). Tfakkira mil-Lezzjoni 3: safety hija indikatur viżiv, mhux permess. Sors: Configuration reference.

Oħloq modalitajiet adattati għax-xogħol tiegħek

Il-lezzjoni dwar il-modalitajiet unifikati introduċiet il-kunċett; issa wasal iż-żmien li ttestjah. Se nibnu tliet modalitajiet personalizzati li jkopru ħtiġijiet rikorrenti għal kull żviluppatur: reviżjoni tal-kodiċi, dispjegament (deployment), u linting. Kull wieħed huwa fajl .toml imqiegħed f’~/.vibe/agents/, b’istruzzjonijiet adattati. Dak li jiddistingwi dawn it-tliet modalitajiet mhux daqshekk l-istruzzjonijiet tagħhom, iżda l-par enabled_tools / [tools.<tool>]: dan jiddeċiedi x’jista’ jmiss Vibe, u għalhekk liema riskju qed tiffaċċja; safety hija sempliċiment it-tikketta viżiva.

Reviżur li ma jista’ jkisser xejn

Il-modalità ta’ reviżjoni tal-kodiċi (code review) tbiddel lil Vibe f’reviżur eżiġenti li janalizza l-kwalità, is-sigurtà u l-manutenibbiltà tal-kodiċi tiegħek. Peress li jaqra biss, huwa mmarkat bħala safe, u l-għodod tal-qari tiegħu huma stabbiliti għal permission = "always": jaħdem mingħajr ma jinterrompik, u mingħajr riskju peress li l-ebda fajl ma se jiġi mmodifikat. Il-lista tal-għodod iżżomm din il-wegħda: l-ebda write_file, l-ebda edit, l-ebda 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"

Il-format tal-output infurzat fil-prompt mhuwiex kożmetiku: jippermettilek tissepara f’daqqa t’għajn dak li jimblokaw pull request u dak li jista’ jistenna. Tniedi l-modalità, imbagħad tagħtih jew istruzzjoni ħielsa jew ambitu speċifiku.

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

Dispjegament li jirrifjuta li jimprovviża

Il-modalità deploy hija l-eżatt oppost. Tmiss il-produzzjoni, għalhekk hija mmarkata bħala destructive, u l-għodod tal-kitba u bash tagħha jibqgħu f’permission = "ask": kull azzjoni teħtieġ il-validazzjoni tiegħek. Il-valur sħiħ tal-modalità jinsab fis-sekwenza fissa tal-prompt tagħha, u speċjalment fil-kundizzjonijiet ta’ waqfien tagħha. Dispjegament improvviżat ta’ Lejl il-Ġimgħa dejjem jibda b’pass maqfuż; hawnhekk, test ħamrani iwaqqaf kollox.

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

Il-preżenza ta’ ask_user_question fl-għodod hija essenzjali: mingħajrha, il-pass 5 ikun biss xewqa, peress li l-aġent ma jkollu l-ebda mod tekniku biex jistaqsik.

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

Tindifa awtomatika iżda dixxiplinata

Bejn iż-żewġt itruf hemm il-modalità lint, li tawtomatizza l-iffurmar (formatting), il-konvenzjonijiet u s-sortjar tal-importazzjonijiet. Timmodifika fajls, għalhekk hija neutral, iżda l-korrezzjonijiet tagħha huma mekkaniċi u reversibbli permezz ta’ Git: l-approvazzjoni tal-għodod tagħha minnufih (permission = "always") tiffrankalek milli tikklikkja ħamsin darba. Jekk il-lista tagħha tinkludi bash, agħmel dan biss f’ambjent iżolat, jew illimita bash għal allowlist ta’ kumandi ta’ lint biss. It-tliet regoli fl-aħħar tal-prompt huma dak li jżommha milli toħroġ mill-binarji—aġent li jaħdem ħieles malajr jinstalla Biome f’proġett li jgħix perfettament tajjeb b’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"

Żewġ modalitajiet oħra, u regola ta’ organizzazzjoni

L-istess raġunament japplika għal ħtiġijiet oħra. Modalità tad-dokumentazzjoni tibqa’ neutral iżda żżomm write_file u edit f’"ask", għax il-ġenerazzjoni ta’ fajls f’repożitorju teħtieġ ħarsa qabel il-kitba.

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

Modalità ta’ migrazzjoni, min-naħa l-oħra, tingħaqad ma’ deploy fil-kategorija destructive: migrazzjoni ta’ skema ħażina ma tistax titħassar b’git revert, għalhekk ir-rekwiżit għal skritt ta’ rollback sistematiku.

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

Fl-aħħar nett, organizza d-direttorju tal-aġenti tiegħek sabiex il-kritikalità tkun leġibbli fis-siġra tal-istruttura nnifisha. Meta tbiddel il-modalitajiet permezz tat-tastiera f’nofs sessjoni, għandek bżonn tkun taf mingħajr ma taħseb jekk il-modalità li għadek kemm attivat tistax tikteb fuq id-disk tiegħek.

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

Punti Ewlenin

  • Kull modalità hija fajl .toml f’~/.vibe/agents/ iddisinjat għal fluss ta’ xogħol speċifiku
  • Il-modalità review għandha biss għodod tal-qari, approvati minnufih: tista’ taqra biss
  • Il-modalità deploy iżżomm bash u l-kitba f’"ask": titlob konferma
  • Il-modalità lint tapprova l-għodod tal-editjar tagħha minnufih: tissemma awtomatikament
  • Aġġusta active_model skont il-kumplessità tal-kompitu
  • L-instructions huma ċ-ċavetta: kun preċiż dwar is-sekwenza u r-regoli