Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Προσαρμοσμένες Λειτουργίες: Code Review, Deploy, Lint

Μάθημα 9 / 14 Ενημερώθηκε 2 Νοεμβρίου 2026 Προχωρημένος
Σε αυτήν τη σελίδα
  1. Δημιουργία λειτουργιών προσαρμοσμένων στη ροή εργασίας σας
  2. Ένας αναθεωρητής που δεν μπορεί να καταστρέψει τίποτα
  3. Μια ανάπτυξη που αρνείται να αυτοσχεδιάσει
  4. Αυτόματος αλλά πειθαρχημένος καθαρισμός
  5. Δύο ακόμη λειτουργίες και ένας κανόνας οργάνωσης
  6. Βασικά σημεία

Το μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026. Τα αρχεία πρακτόρων παραδείγματος χρησιμοποιούν πλέον τα κλειδιά που τεκμηριώνονται από το Vibe: instructions (όχι system_prompt), active_model (όχι model), μπλοκ [tools.<tool>] για εγκρίσεις (το κλειδί auto_approve δεν υπάρχει σε αρχείο πράκτορα) και πραγματικά ονόματα εργαλείων (edit, όχι edit_file· κανένα εργαλείο list_dir). Υπενθύμιση από το Μάθημα 3: το safety είναι ένας οπτικός δείκτης, όχι μια άδεια. Πηγή: Configuration reference.

Δημιουργία λειτουργιών προσαρμοσμένων στη ροή εργασίας σας

Το μάθημα για τις ενοποιημένες λειτουργίες εισήγαγε την έννοια· ήρθε η ώρα να την θέσετε σε δοκιμασία. Θα δημιουργήσουμε τρεις προσαρμοσμένες λειτουργίες που καλύπτουν επαναλαμβανόμενες ανάγκες για κάθε προγραμματιστή: αναθεώρηση κώδικα, ανάπτυξη (deployment) και linting. Κάθε μία είναι ένα αρχείο .toml τοποθετημένο στο ~/.vibe/agents/, με προσαρμοσμένες οδηγίες. Αυτό που διακρίνει αυτές τις τρεις λειτουργίες δεν είναι τόσο οι οδηγίες τους όσο το ζεύγος enabled_tools / [tools.<tool>]: αυτό αποφασίζει τι μπορεί να αγγίξει το Vibe και, κατά συνέπεια, ποιος κίνδυνος διατρέχετε· το safety είναι απλώς η οπτική ετικέτα.

Ένας αναθεωρητής που δεν μπορεί να καταστρέψει τίποτα

Η λειτουργία αναθεώρησης κώδικα μετατρέπει το Vibe σε έναν απαιτητικό αναθεωρητή που αναλύει την ποιότητα, την ασφάλεια και τη συντηρησιμότητα του κώδικά σας. Επειδή διαβάζει μόνο, επισημαίνεται ως safe και τα εργαλεία ανάγνωσής του ορίζονται σε permission = "always": λειτουργεί χωρίς να σας διακόπτει και χωρίς κίνδυνο, καθώς κανένα αρχείο δεν θα τροποποιηθεί. Η λίστα εργαλείων τηρεί αυτή την υπόσχεση: κανένα write_file, κανένα edit, κανένα 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"

Η μορφή εξόδου που επιβάλλεται στο prompt δεν είναι καλλωπιστική: σας επιτρέπει να ταξινομήσετε με μια ματιά τι μπλοκάρει ένα pull request και τι μπορεί να περιμένει. Εκκινείτε τη λειτουργία και στη συνέχεια της δίνετε είτε μια οδηγία ελεύθερης μορφής είτε ένα συγκεκριμένο πεδίο εφαρμογής.

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

Μια ανάπτυξη που αρνείται να αυτοσχεδιάσει

Η λειτουργία deploy είναι ακριβώς το αντίθετο. Αγγίζει το περιβάλλον παραγωγής, επομένως επισημαίνεται ως destructive και τα εργαλεία εγγραφής και bash παραμένουν σε permission = "ask": κάθε ενέργεια απαιτεί την επικύρωσή σας. Η entire αξία της λειτουργίας έγκειται στην καθορισμένη ακολουθία του prompt της και, κυρίως, στις συνθήκες διακοπής της. Μια αυτοσχεδιασμένη ανάπτυξη Παρασκευή βράδυ ξεκινά πάντα με ένα βήμα που παραλείφθηκε· εδώ, ένα κόκκινο τεστ σταματά τα πάντα.

# ~/.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 στα εργαλεία είναι απαραίτητη: χωρίς αυτό, το βήμα 5 θα ήταν ευσεβής πόθος, καθώς ο πράκτορας δεν θα είχε τεχνικό τρόπο να σας θέσει ερώτηση.

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

Αυτόματος αλλά πειθαρχημένος καθαρισμός

Ανάμεσα στα δύο βρίσκεται η λειτουργία lint, η οποία αυτοματοποιεί τη μορφοποίηση, τις συμβάσεις και την ταξινόμηση των imports. Τροποποιεί αρχεία, επομένως είναι neutral, αλλά οι διορθώσεις της είναι μηχανικές και αναστρέψιμες μέσω Git: η έγκριση των εργαλείων της εκ των προτέρων (permission = "always") σας γλιτώνει από το να κάνετε κλικ πενήντα φορές. Εάν η λίστα της περιλαμβάνει bash, κάντε το μόνο σε απομονωμένο περιβάλλον ή περιορίστε το bash σε μια allowlist μόνο για εντολές lint. Οι τρεις κανόνες στο τέλος του prompt είναι αυτοί που την εμποδίζουν να ξεφύγει—ένας πράκτορας που τρέχει ελεύθερα θα εγκαταστήσει γρήγορα το Biome σε ένα έργο που ζει μια χαρά με το 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"

Δύο ακόμη λειτουργίες και ένας κανόνας οργάνωσης

Η ίδια λογική ισχύει και για άλλες ανάγκες. Μια λειτουργία τεκμηρίωσης παραμένει neutral αλλά διατηρεί τα write_file και edit σε "ask", επειδή η δημιουργία αρχείων σε ένα αποθετήριο αξίζει μια ματιά πριν την εγγραφή.

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

Μια λειτουργία migration, εν τω μεταξύ, εντάσσεται στην κατηγορία destructive μαζί με το deploy: μια αποτυχημένη migration σχήματος δεν μπορεί να αναιρεθεί με ένα git revert, εξ ου και η απαίτηση για ένα συστηματικό script επαναφοράς (rollback).

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

Τέλος, οργανώστε τον κατάλογο των πρακτόρων σας ώστε η κρισιμότητα να είναι αναγνώσιμη στην ίδια τη δομή του δέντρου. Όταν αλλάζετε λειτουργίες μέσω πληκτρολογίου κατά τη διάρκεια μιας συνεδρίας, πρέπει να γνωρίζετε χωρίς να σκέφτεστε εάν η λειτουργία που μόλις ενεργοποιήσατε μπορεί να γράψει στον δίσκο σας.

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

Βασικά σημεία

  • Κάθε λειτουργία είναι ένα αρχείο .toml στο ~/.vibe/agents/ σχεδιασμένο για μια συγκεκριμένη ροή εργασίας
  • Η λειτουργία review διαθέτει μόνο εργαλεία ανάγνωσης, εγκεκριμένα εκ των προτέρων: μπορεί μόνο να διαβάσει
  • Η λειτουργία deploy διατηρεί τα bash και την εγγραφή σε "ask": ζητά επιβεβαίωση
  • Η λειτουργία lint εγκρίνει τα εργαλεία επεξεργασίας της εκ των προτέρων: διορθώνει αυτόματα
  • Προσαρμόστε το active_model ανάλογα με την πολυπλοκότητα της εργασίας
  • Οι instructions είναι το κλειδί: να είστε ακριβείς σχετικά με την ακολουθία και τους κανόνες