Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Móid Saincheaptha: Athbhreithniú Cód, Imscaradh, Lint

Ceacht 9 as 14 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Cruthaigh móid atá oiriúnaithe do d’fhobair
  2. Athbhreithnitheoir nach féidir aon rud a bhriseadh
  3. Imscaradh a dhiúltaíonn impromptú
  4. Glanadh uathoibríoch ach discíplíneach
  5. Dhá mhód eile, agus riail eagraíochta
  6. Príomhphointí

An ceacht nuashonraithe an 2 Samhain, 2026. Úsáideann comhaid ghníomhaire samplacha anois eochracha atá doiciméadaithe ag Vibe: instructions (seachas system_prompt), active_model (seachas model), blocanna [tools.<tool>] le haghaidh formheasanna (níl an eochair auto_approve i gcomhad gníomhaire), agus ainmneacha fíor uirlisí (edit, seachas edit_file; gan uirlis list_dir). Meabhrúchán ó Cheacht 3: is táscaire amhairc é safety, ní cead. Foinse: Tagairt chumraíochta.

Cruthaigh móid atá oiriúnaithe do d’fhobair

Thug an ceacht ar mhóid aontaithe isteach an coincheap; anois tá sé in am é a chur faoi thástáil. Déanfaimid trí mhód saincheaptha a chlúdaíonn riachtanais athfhillteacha do gach forbróir: athbhreithniú cóid, imscaradh, agus lintáil. Is comhad .toml gach ceann acu a chuirtear in ~/.vibe/agents/, le treoracha saincheaptha. Ní na treoracha féin an rud is mó a idirdhealaíonn na trí mhód seo, ach an péire enabled_tools / [tools.<tool>]: is é seo a chinneann cad is féidir le Vibe a bhaint amach, agus dá bhrí sin cén riosca atá romhat; ní lipéad amhairc ach oiread é safety.

Athbhreithnitheoir nach féidir aon rud a bhriseadh

Tiontaíonn an mód athbhreithnithe cóid Vibe ina athbhreithnitheoir éilitheach a dhéanann anailís ar cháilíocht, slándáil, agus inchothabháil do chóid. Ós rud é nach léann sé ach, tá sé marcáilte safe, agus tá a uirlisí léitheoireachta socraithe go permission = "always": oibríonn sé gan tú a chur isteach, agus gan riosca toisc nach ndéanfar aon chomhad a mhodhnú. Coinníonn an liosta uirlisí an gealltanas seo: gan write_file, gan edit, gan 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"

Níl an fhormáid aschuir a fhorghníomhthaítear sa leid cosmaideach: ligeann sé duit sórtáil ar an toirt cad a chuireann bac ar iarratas tarraingthe agus cad is féidir fanacht leis. Seolann tú an mód, agus ansin tugann tú treoir saorchruthach nó scóip shonrach dó.

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

Imscaradh a dhiúltaíonn impromptú

Is é an mód imscartha an contrárthacht beacht. Baineann sé le táirgeadh, mar sin tá sé marcáilte destructive, agus fanann a uirlisí scríofa agus bash ag permission = "ask": éilíonn gach gníomh do bhailíochtú. Is sa seicheamh seasta dá leid, agus go háirithe ina choinníollacha stoptha, atá luach iomlán an mhóid. Tosaíonn imscaradh impromptú Dé hAoine i gcónaí le céim a scipeáladh; anseo, stopann tástáil dhearg gach rud.

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

Tá láithreacht ask_user_question sna huirlisí riachtanach: gan é, bheadh céim 5 ina bhrionglóid, toisc nach mbeadh aon bhealach teicniúil ag an ngníomhaire ceist a chur ort.

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

Glanadh uathoibríoch ach discíplíneach

Idir an dá cheann suíonn an mód lint, a uathoibríonn formáidiú, coinbhinsiúin, agus sórtáil allmhairithe. Modhnaíonn sé comhaid, mar sin tá sé neutral, ach tá a cheartúcháin meicniúil agus inbhéartaithe trí Git: sábhálann formheas a chuid uirlisí ar fad (permission = "always") thú ó chliceáil caoga uair. Má áirítear bash ina liosta, déan é sin i dtimpeallacht aonair amháin, nó teorainn bash le allowlist d’orduithe lint amháin. Is iad na trí riail ag deireadh an leid a choinníonn sé ó dhul ar strae – déanfaidh gníomhaire a ritheann go saor Biome a shuiteáil go tapa i dtionscadal a mhaireann go foirfe le 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"

Dhá mhód eile, agus riail eagraíochta

Baineann an réasúnaíocht chéanna le riachtanais eile. Fanann mód doiciméadúcháin neutral ach coinníonn sé write_file agus edit ag "ask", toisc go dtuilleann giniúint comhad i stór seicheamh breathnú sula scríobhtar iad.

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

Ina theannta sin, téann mód imirce isteach sa chatagóir destructive in éineacht le himscaradh: ní féidir imirce scéime botúnach a chealú le git revert, hence an riachtanas do script rolltaigh siar córasach.

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

Ar deireadh, eagraigh do chomhadlann gníomhairí ionas go mbeidh an chriticiúlacht inléite i struchtúr na crainne féin. Nuair a athraíonn tú móid trí mhéarchlár le linn seisiúin, ní mór duit a bheith ar an eolas gan smaoineamh an féidir leis an mód a ghníomhachtaigh tú díreach scríobh chuig do dhiosca.

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

Príomhphointí

  • Is comhad .toml gach mód in ~/.vibe/agents/ atá deartha d’fhobair shonrach
  • Níl ach uirlisí léitheoireachta ag an mód athbhreithnithe, formheasta go hiomlán: ní féidir leis ach léamh
  • Coinníonn an mód imscairthe bash agus scríobh ag "ask": iarrann sé deimhniú
  • Formheasann an mód lint a chuid uirlisí eagarthóireachta go hiomlán: deisíonn sé go huathoibríoch
  • Coigeartaigh active_model de réir castacht na tasc
  • Is iad na instructions an eochair: bí beacht faoin seicheamh agus na rialacha