Mukautetut tilat: Koodikatselmus, käyttöönotto, Lint
Tällä sivulla
Oppitunti päivitetty 2. marraskuuta 2026. Esimerkkiagenttitiedostot käyttävät nyt Viben dokumentoimia avaimia:
instructions(eisystem_prompt),active_model(eimodel),[tools.<tool>]-lohkot hyväksyntöjä varten (auto_approve-avainta ei ole olemassa agenttitiedostossa) ja todellisia työkalujen nimiä (edit, eiedit_file; eilist_dir-työkalua). Muistutus oppitunnista 3:safetyon visuaalinen indikaattori, ei käyttöoikeus. Lähde: Configuration reference.
Luo tiloja, jotka on räätälöity työvirtaasi varten
Yhdistettyjen tilojen oppitunti esitteli käsitteen; nyt on aika laittaa se testiin. Rakennamme kolme mukautettua tilaa, jotka kattavat jokaisen kehittäjän toistuvat tarpeet: koodikatselmus, käyttöönotto ja lintaaminen. Jokainen niistä on .toml-tiedosto, joka sijoitetaan hakemistoon ~/.vibe/agents/ ja sisältää räätälöidyt ohjeet. Näitä kolmea tilaa ei erota niinkään niiden ohjeet kuin enabled_tools / [tools.<tool>] -pari: tämä päättää, mihin Vibe voi koskea, ja siten millaiselle riskille altistut; safety on pelkkä visuaalinen etiketti.
Katselmoija, joka ei voi rikkoa mitään
Koodikatselmustila muuttaa Viben vaativaksi katselmoijaksi, joka analysoi koodisi laatua, turvallisuutta ja ylläpidettävyyttä. Koska se vain lukee, se on merkitty arvolla safe, ja sen lukutyökalut on asetettu arvoon permission = "always": se toimii keskeyttämättä sinua ja ilman riskiä, koska tiedostoja ei muokata. Työkalulista pitää tämän lupauksen: ei write_file, ei edit, ei 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"
Kehotteessa pakotettu tulostusmuoto ei ole kosmeettinen: sen avulla voit lajitella silmäyksellä sen, mikä estää vetopyynnön (pull request) ja mikä voi odottaa. Käynnistät tilan ja annat sille joko vapaan muotoisen ohjeen tai tietyn laajuuden.
vibe --agent review
# > Analyze modified files in the current branch
# > /review src/api/
Käyttöönotto, joka kieltäytyy improvisoimasta
Deploy-tila on täsmälleen päinvastainen. Se koskettaa tuotantoa, joten se on merkitty arvolla destructive, ja sen kirjoitus- sekä bash-työkalut pysyvät arvossa permission = "ask": jokainen toiminta vaatii validointiasi. Koko tilan arvo piilee kehotteen kiinteässä sekvenssissä ja erityisesti sen pysäytysehdoissa. Improvisoitu perjantai-illan käyttöönotto alkaa aina ohitetulla askeleella; tässä punainen testi pysäyttää kaiken.
# ~/.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"
ask_user_question-työkalun olemassaolo on välttämätöntä: ilman sitä askel 5 olisi toiveajattelua, sillä agentilla ei olisi teknistä tapaa kysyä sinulta.
vibe --agent deploy
# > Follows the sequence test → build → deploy → verification
Automaattinen mutta kurinalainen siivous
Näiden kahden välissä on lint-tila, joka automatisoi muotoilun, käytänteet ja importtien järjestelyn. Se muokkaa tiedostoja, joten se on neutral, mutta sen korjaukset ovat mekaanisia ja peruutettavissa Gitin kautta: sen työkalujen hyväksyminen suoraan (permission = "always") säästää sinua napsauttamasta viittäkymmentä kertaa. Jos sen lista sisältää bash-työkalun, tee se vain eristetyssä ympäristössä tai rajoita bash koskemaan vain lint-komentojen allowlist-listaa. Kehotteen lopussa olevat kolme sääntöä pitävät sen raiteillaan – vapaasti juokseva agentti asentaa nopeasti Biomen projektiin, joka elää täydellisesti hyvin ESLintin kanssa.
# ~/.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"
Kaksi tilaa lisää ja organisaatiosääntö
Sama päättely pätee muihinkin tarpeisiin. Dokumentaatiotila pysyy neutral-tilana, mutta pitää write_file- ja edit-työkalut arvossa "ask", koska tiedostojen generointi repositorioon ansaitsee silmäyksen ennen kirjoittamista.
# ~/.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"
Migraatiotila puolestaan liittyy deploy-tilaan destructive-kategoriassa: epäonnistunutta skeemamigraatiota ei voi peruuttaa git revert-komennolla, joten systemaattinen palautusskripti on pakollinen.
# ~/.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"
Lopuksi järjestä agents-hakemistosi niin, että kriittisyys on luettavissa itse puurakenteesta. Kun vaihdat tiloja näppäimistöllä istunnon aikana, sinun on tiedettävä ajattelematta, voiko juuri aktivoimasi tila kirjoittaa levyllesi.
~/.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
Keskeiset asiat
- Jokainen tila on
.toml-tiedosto hakemistossa~/.vibe/agents/, suunniteltu tiettyä työvirtaa varten - Review-tilassa on vain lukutyökaluja, jotka on hyväksytty suoraan: se voi vain lukea
- Deploy-tila pitää
bash- ja kirjoitustyökalut arvossa"ask": se pyytää vahvistusta - Lint-tila hyväksyy muokkaustyökalunsa suoraan: se korjaa automaattisesti
- Säädä
active_modeltehtävän monimutkaisuuden mukaan instructionsovat avainasemassa: ole tarkka sekvenssistä ja säännöistä