Móid Saincheaptha: Athbhreithniú Cód, Imscaradh, Lint
Ar an leathanach seo
An ceacht nuashonraithe an 2 Samhain, 2026. Úsáideann comhaid ghníomhaire samplacha anois eochracha atá doiciméadaithe ag Vibe:
instructions(seachassystem_prompt),active_model(seachasmodel), blocanna[tools.<tool>]le haghaidh formheasanna (níl an eochairauto_approvei gcomhad gníomhaire), agus ainmneacha fíor uirlisí (edit, seachasedit_file; gan uirlislist_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
.tomlgach 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
bashagus 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_modelde réir castacht na tasc - Is iad na
instructionsan eochair: bí beacht faoin seicheamh agus na rialacha