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

Modalitajiet Unifikati: Ngħaqqad Għodod, Permessi, u Imġiba

Lezzjoni 4 / 14 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Il-kunċett ta’ modalitajiet unifikati
  2. L-istruttura ta’ modalità unifikata
  3. Id-disinn ta’ modalitajiet komplementari
  4. L-ibdil bejn il-modalitajiet u l-organizzazzjoni tagħhom
  5. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru 2026. Il-fajls tal-aġenti tal-eżempju issa jużaw ċ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 ta’ aġent), u ismijiet reali tal-għodod (edit, mhux edit_file; l-ebda għodda list_dir). Tifkira mil-Lezzjoni 3: safety hija indikatur viżiv, mhux permess. Sors: Referenza tal-konfigurazzjoni.

Il-kunċett ta’ modalitajiet unifikati

L-aġenti personalizzati li koprejna fil-lezzjonijiet preċedenti jiddefinixxu profil statiku: mudell, sett ta’ għodod, u livell ta’ sikurezza. Il-modalitajiet unifikati imorru lil hinn billi jgħaqqdu dimensjonijiet multipli f’konfigurazzjoni waħda u koerenti li tista’ tattivaha b’ġesta waħda. Modalità unifikata tgħaqqad għodod awtorizzati, permessi speċifiċi, imġiba mmexxija mill-prompt tas-sistema, regoli ta’ approvazzjoni awtomatika, u restrizzjonijiet kuntestwali.

Il-valur isir ovvju meta x-xogħol tiegħek jinbidel diversi drabi f’jum. Mingħajr modalitajiet unifikati, timmanipula ħafna settings kull darba li jinbidel il-kuntest tiegħek: tgħaddi mir-reviżjoni tal-kodiċi għad-deploy, u trid tbiddel l-aġenti, taġġusta l-permessi, u timmodifika l-prompt. Modalità unifikata tikkapsula dan kollu f’profil wieħed, li tattivah fil-bidu jew f’nofs sessjoni.

# Attiva l-modalità "deploy"
vibe --agent deploy-mode

# Ibdel għall-modalità "review"
# Shift+Tab → agħżel review-mode

L-istruttura ta’ modalità unifikata

Teknikament, modalità unifikata hija aġent personalizzat; id-differenza minn aġent klassiku hija kunċettwali. Inti ma tfassalx il-fajl .toml bħala “assistent li jista’ jagħmel X,” iżda bħala kuntest sħiħ ta’ xogħol: x’tista’ tagħmel matul din il-fażi tal-proġett, b’liema livell ta’ prekawzjoni, u f’liema forma jirritornawlek ir-riżultati.

Il-modalità ta’ reviżjoni hawn taħt turi dan l-aktar b’mod ċar. Hija biss għall-qari (read-only), allura hija approvata awtomatikament mingħajr riskju, u l-prompt tagħha jinfurza format ta’ rapport li tista’ twaħħal direttament f’pull request.

# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Code review mode: read-only, deep analysis, suggestions."

safety = "safe"
active_model = "mistral-medium-3.5"  # model built into Vibe

instructions = """
You are in code review mode.
Goal: analyze code quality, security, and maintainability.
Rules:
- Never modify files
- Produce a structured report (critical issues, warnings, suggestions)
- Cite affected code lines with their line numbers
- Propose fixes as diffs
Output format: Markdown with Critical / Warning / Suggestion sections
"""

enabled_tools = [
  "read_file",
  "grep",
]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Il-modalità ta’ deploy hija l-oppost eżatt tagħha, u dak il-kuntrast huwa intenzjonali. Għandha bash, allura tista’ tkisser affarijiet, iżda l-permessi ask tagħha fuq write_file u bash iżommuk fiċ-ċiklu, u l-prompt tagħha jiddeskrivi sekwenza stretta li l-aġent irid isegwi mill-bidu sal-aħħar.

# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Deploy mode: build, test, deploy with validation at each step."

safety = "destructive"
active_model = "codestral"  # alias declared in config.toml (Lesson 2)

instructions = """
You are in deploy mode.
Mandatory sequence:
1. Verify that all tests pass
2. Build the project
3. Validate the build (no errors, no warnings)
4. Request confirmation before actual deployment
5. Deploy
6. Verify that the service responds
Never deploy if tests fail.
"""

enabled_tools = [
  "read_file",
  "write_file",
  "bash",
  "grep",
  "ask_user_question"
]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

Id-disinn ta’ modalitajiet komplementari

L-idea hija li toħloq sett ta’ modalitajiet li jkopru ċ-ċiklu ta’ żvilupp tiegħek, mill-esplorazzjoni sal-fixing. Il-modalità ta’ esplorazzjoni tmexxi t-triq: biss għall-qari u approvata awtomatikament, tgħinek tifhem repository qabel ma tmissu.

display_name = "Explore Mode"
safety = "safe"
instructions = """Explore the codebase, identify the architecture, patterns, and dependencies."""
enabled_tools = ["read_file", "grep",]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Imbagħad tiġi l-modalità Dev, fejn se tqatta’ l-biċċa l-kbira tal-ħin tiegħek. Tikteb u tħaddem kumandi—biex tħaddem it-testijiet, pereżempju—iżda titlob l-approvazzjoni tiegħek, u l-prompt tagħha jorbot kull bidla mal-kitba ta’ testijiet.

display_name = "Dev Mode"
safety = "neutral"
instructions = """Implement the requested features. Write tests for every change."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]

[tools.write_file]
permission = "ask"

[tools.edit]
permission = "ask"

[tools.bash]
permission = "ask"

Fl-aħħar nett, il-modalità Fix hija deliberatament dejqa. L-ebda write_file, biss edit: l-aġent jimmodifika kodiċi eżistenti mingħajr ma joħloq fajls ġodda, li jipprevjenih milli “jirrefattorizza fit-triq” bug li sempliċiment talbtu jiffissa. Peress li hija daqshekk ristretta, nistgħu napprovawha awtomatikament b’mod sikur.

display_name = "Fix Mode"
safety = "neutral"
instructions = """Fix reported bugs. Minimize changes. Touch only the affected code."""
enabled_tools = ["read_file", "edit", "grep"]

[tools.read_file]
permission = "always"

[tools.edit]
permission = "always"

[tools.grep]
permission = "always"

L-ibdil bejn il-modalitajiet u l-organizzazzjoni tagħhom

F’sessjoni interattiva, Shift+Tab iċċikla bejn il-modalitajiet: Vibe juri l-lista tal-aġenti kollha tiegħek, integrati u personalizzati, bid-deskrizzjonijiet tagħhom—hawnhekk fejn id-deskrizzjonijiet attenti mil-lezzjoni preċedenti jagħmlu d-differenza. Mill-linja tal-kmand, tibda direttament f’modalità, jew tispezzjona l-kontenut tad-direttorju tal-aġenti.

# Ibda direttament f'modalità
vibe --agent review-mode

# Elenga l-aġenti disponibbli
ls ~/.vibe/agents/

Fl-aħħar nett, adotta konvenzjoni ta’ smijiet ċara. Is-suffiss -mode jiddistingwi immedjatament il-kuntesti tax-xogħol tiegħek minn aġenti ta’ utilità aktar ad hoc, u l-ordni alfabetika tad-direttorju tibqa’ leġibbli anke wara doġina fajls.

~/.vibe/agents/
├── review-mode.toml      # Code review
├── deploy-mode.toml      # Deployment
├── dev-mode.toml         # Development
├── fix-mode.toml         # Fixes
├── explore-mode.toml     # Exploration
└── doc-mode.toml         # Documentation

Punti Ewlenin

  • Modalità unifikata hija aġent personalizzat iddisinjat bħala kuntest sħiħ ta’ xogħol
  • Tgħaqqad għodod, permessi, prompt tas-sistema, u mudell f’konfigurazzjoni waħda
  • Oħloq modalitajiet komplementari biex tkopri ċ-ċiklu ta’ żvilupp tiegħek
  • Shift+Tab jippermettilek tibdel bejn il-modalitajiet f’ħin reali
  • Semmi l-fajls tiegħek b’mod konsistenti biex tkun tista’ ssibhom faċilment
  • Kull modalità trid ikollha għan ċar u permessi xierqa