Kaip užtikrinti, kad dirbtinio intelekto asistentas laikytųsi jūsų projekto kodavimo konvencijų?

Question

Accepted Answer

DI pagal numatytuosius nustatymus naudoja bendras jos mokymo duomenų vidurkis, todėl norint gauti **jūsų** stilių, turite jį **parodyti ir įgyvendinti** — naudodami pavyzdžius, aiškų taisyklių failą ir linter ciklą, kuris sulaiko tai, kas praeina. Nepasitikinkim, kad dirbtinis intelektas atspės jūsų standartus (WordPress Coding Standards, PSR-12 ir kt.).

## Metodai (pagal poveikio laipsnį)

- **Pateikite linter konfigūraciją ir pavyzdžius** — įklijuokite savo `.eslintrc`, `phpcs.xml` arba `.editorconfig`. Tai yra taisyklės mašinos tikrintine forma, ir DI jas gali perskaityti.
- **Palikite taisyklių/nurodymų failą** — `CLAUDE.md` arba sisteminį iš anksto nustatą tekstą, kuris aiškiai nustato standartą: "Šis projektas laikosi **PSR-12**. Naudokite 4 tarpų įtraukimą, skliaustus kitoje funkcijų eilutėje, snake_case apasimai." Nuolatiniai nurodymai nuvokia savęs kartojimą kiekvieno paklausimo metu.
- **Parodykite reprezentatyvų esamą kodą** — vienas ar du švari failai išmoko pavadinimų, struktūros ir idiomų greičiau nei bet kuri aprašymas. DI šablonų atitinka tai, ką regis.
- **Paleiskite linter DI išvestyje ir grąžinkite klaidas** — patikimiausias žingsnis. Linter yra tiesos šaltinis; įklijuokite jo klaidas ir paprašykite DI jas pataisyti.

## Linter ciklas

```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.
```

Šis ciklas greitai suartėja, nes linter suteikia tikslią eilutės lygio atsaką, kuriuo DI gali veikti tiesioginiai, o ne jums aprašant stilių proza.

## Kodėl tai svarbu

Kodas, kuris nepaiso projekto konvencijų, sukuria **peržiūros trinčią ir nenuoseklumą**, net kai jis funkcinai teisingas — peržiūrėtojai praleidžia laiką formatavimui, o kodų bazė dreiduoja. DI neturi jūsų namų stiliaus sąmonės, nebent ją įgyvendinate, todėl darbas yra taisykles padaryti **aiškiomis ir patikrintinomis**: taisyklių failą ketinimui, reprezentatyvų kodą idiomams ir linter kaip taisyklių vykdytojas cikle. Ta pati disciplina (konfigūracija + pavyzdžiai + automatinis patikrinimas) yra tai, kaip jūs įdiegiate žmogų komandos narį jūsų konvencijoms, taip pat.