Πώς κάνετε έναν βοηθό AI να ακολουθήσει τις συμβάσεις κωδικοποίησης του έργου σας;

Question

Accepted Answer

Ένα AI χρησιμοποιεί ως προεπιλογή ένα γενικό μέσο των δεδομένων εκπαίδευσής του, επομένως για να πάρετε **τα δικά σας** στυλ πρέπει να **δείξετε και να εφαρμόσετε** — μέσω παραδειγμάτων, ενός ρητού αρχείου κανόνων και ενός βρόχου linter που συλλαμβάνει αυτά που διαφεύγουν. Μην βασίζεστε στο να μαντέψει τα πρότυπά σας (WordPress Coding Standards, PSR-12, κ.λπ.).

## Τεχνικές (με σειρά επιρροής)

- **Παρέχετε τη διαμόρφωση linter και παραδείγματα** — επικολλήστε το `.eslintrc`, `phpcs.xml` ή `.editorconfig`. Αυτοί είναι οι κανόνες σε μορφή ελεγχόμενη από μηχανή, και το AI μπορεί να τα διαβάσει.
- **Κρατήστε ένα αρχείο κανόνων/οδηγιών** — ένα `CLAUDE.md` ή σύστημα prompt που δηλώνει το πρότυπο ρητά: "Αυτό το έργο ακολουθεί **PSR-12**. Χρησιμοποιήστε 4-space indent, αγκύλες στην επόμενη γραμμή για συναρτήσεις, snake_case για hooks." Μόνιμες οδηγίες υπερτερούν της επανάληψης σας κάθε προτροπή.
- **Εμφανίστε αντιπροσωπευτικό υπάρχον κώδικα** — ένα ή δύο καθαρά αρχεία διδάσκουν ονοματοδοσία, δομή και idioms πιο γρήγορα από οποιαδήποτε περιγραφή. Το AI συνδυάζει τα μοτίβα που βλέπει.
- **Εκτελέστε linter στην έξοδο AI και τροφοδοτήστε σφάλματα πίσω** — το πιο αξιόπιστο βήμα. Το linter είναι η αλήθεια του εδάφους. επικολλήστε τα σφάλματά του και ζητήστε από το AI να τα διορθώσει.

## Ο βρόχος linter

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Αυτός ο βρόχος συγκλίνει γρήγορα επειδή το linter δίνει ακριβή ανάδραση επιπέδου γραμμής που το AI μπορεί να δράσει άμεσα, αντί να περιγράφετε το στυλ σε πρόζα.

## Γιατί έχει σημασία

Ο κώδικας που αγνοεί τις συμβάσεις του έργου δημιουργεί **τριβή ανασκόπησης και ασυνέπεια** ακόμη και όταν είναι λειτουργικά σωστός — οι ανασκοποί σπαταλούν χρόνο στη μορφοποίηση και η κωδική βάση παρασύρεται. Ένα AI δεν έχει επίγνωση του στυλ του σπιτιού σας εκτός αν το παρέχετε, επομένως το έργο είναι να κάνετε τους κανόνες **ρητούς και ελεγχόμενους**: ένα αρχείο κανόνων για πρόθεση, αντιπροσωπευτικό κώδικα για idioms, και το linter ως επαγωγό στο βρόχο. Η ίδια πειθαρχία (διαμόρφωση + παραδείγματα + αυτοματοποιημένος έλεγχος) είναι επίσης το πώς ενσωματώνετε έναν ανθρώπινο συνάδελφο ομάδας στις συμβάσεις σας.