AI arendustöövoog: praktiline juhend algajale
Pikem praktiline juhend algajale: milline LLM valida, kuidas AI olemasolevasse PHP + Docker setupi lisada ja kuidas seda turvaliselt kasutada vanas koodibaasis.
Kui sa alles alustad AI kasutamist arenduses, on segadus täiesti normaalne: milline tööriist valida, kuidas see olemasolevasse setupi panna ja kust üldse pihta hakata. Lisaks on alguses keeruline eristada, mis on päriselt kasulik ja mis on lihtsalt hype. Seetõttu on see artikkel teadlikult "maapealne": päris näited, kopeeritavad mallid ja sammud, mida saad teha kohe. Esiteks saad kiire ülevaate, teiseks saad tegevusplaani ja lõpuks saad kopeeritavad mallid.
Mida see artikkel lahendab?
See postitus vastab kolmele küsimusele, mida algajad kõige rohkem küsivad. Samuti näed iga punkti juures, mida see igapäevatöös tegelikult tähendab. Teisisõnu saad kohe aru, mida teha täna, mida teha järgmisel nädalal ja mida jätta hilisemaks.
| Küsimus | Lühivastus | Mida see praktikas tähendab |
|---|---|---|
| Milline LLM valida? | Alusta ühest mudelist ja 1-2 kasutusjuhust. | PR kokkuvõtted + koodiselgitus esimesel nädalal. |
| Kuidas integreerida olemasolevasse infrasse? | Lisa AI appi, mitte süsteemi keskmesse. | Feature flag + üks AI teenuse kiht. |
| Kuidas kasutada vanas koodibaasis? | AI teeb mustandi, inimene kinnitab. | Sama review ja testiprotsess nagu varem. |
1) Vali esimene eesmärk ja mõõdik
Algaja suurim viga on "proovime kõike korraga". Tee vastupidi: vali üks töö ja üks mõõdik. Seetõttu saad kohe aru, kas AI aitab või tekitab lisatööd.
Näide algajale:
- ülesanne: PR kirjeldus võtab praegu 20 minutit;
- eesmärk: viia see 8-10 minuti peale;
- mõõdik: 10 PR-i keskmine aeg enne ja pärast AI kasutamist.
Kui mõõdetavat eesmärki pole, siis ei saa aru, kas AI aitas või tekitas lihtsalt lisamüra. Lisaks muutub tiimis kokkulepete loomine keeruliseks, sest kõigil on erinev tunnetus tulemusest. Seetõttu tasub üks lihtne mõõdik paika panna juba enne esimest katset.
Head stardikohad:
- PR kokkuvõte;
- koodifaili selgitus uuele tiimiliikmele;
- testi mustand olemasolevale bugfixile.
Väike ja mõõdetav võit esimesel nädalal on parem kui suur "AI strateegia", mis ei jõua kunagi kasutusse.
2) Vali tööriist ilma ülemõtlemata
LLM tähendab lihtsalt AI vestlusmudelit. Algajana ära vali "täiuslikku", vali "piisavalt hea" ja alusta. Seejärel saad juba päris tulemuste põhjal otsustada, kas ja millal on vaja tööriista vahetada. Näiteks võid 7 päeva järel võrrelda, kas PR kirjeldused valmivad kiiremini kui varem.
| Valik | Milleks sobib | Algaja soovitus |
|---|---|---|
| AI vestlusaken | Koodiselgitus, ideed, PR tekstid | Parim esimene samm |
| IDE AI plugin | Autocompletion ja refaktor | Lisa pärast esimest 1-2 nädalat |
| API integratsioon | Automatiseeritud vood rakenduses | Võta siis, kui kasutusjuht on juba selge |
Eesmärk pole "kõige võimsam setup". Eesmärk on esimesed reaalsed tulemused ning samuti harjumus AI-d järjepidevalt kasutada.
3) Lihtne integreerimine olemasolevasse PHP + Docker setupi
Seda saab teha ka ilma suurt süsteemi ümber ehitamata. Alusta lihtsa skeemiga ning lisa keerukus alles siis, kui vajadus tekib:
- Lisa
.envfaili AI võtmed ja mudeli nimi. - Tee üks keskne teenus AI-kutsete jaoks (mitte suvalised kutsed üle koodi).
- Pane AI osa feature flagi taha (
AI_ENABLED=true/false). - Logi, millises kohas AI-d kasutati ja kas tulemus läks merge'i.
Samas ei pea sa kõike kohe automatiseerima, sest alguses piisab ühest stabiilsest kasutusjuhust.
Mini näide .env failist:
AI_ENABLED=true
AI_MODEL=mini
AI_USECASE_PR_SUMMARY=trueNii on sul kontroll olemas: saad AI funktsiooni vajadusel hetkega välja lülitada. Seetõttu on risk väiksem ka siis, kui mudeli vastused ajutiselt kõikuvad.
Tahad, et see plaan saaks päriselt tööle 1 nädalaga?
Aitame sul paika panna esimesed kasutusjuhud, promptid ja tiimi reeglid, et tulemused oleksid mõõdetavad.
Vaata AI lahendusi →4) "Kopeeri ja kasuta" promptide starter kit
Siin on valmis promptid, mida saad kohe kasutada. Asenda ainult [SINU_KONTEKST].
Lisaks soovitan hoida neid ühes jagatud failis, et kogu tiim kasutaks sama baasi.
Seejärel on lihtsam võrrelda, millised promptid päriselt töötavad ja millised mitte.
Prompt 1: Legacy faili selgitus
"Selgita seda faili algajale.
Vastus olgu: 1) mille eest vastutab, 2) peamised sõltuvused, 3) 2 võimalikku riski.
Kontekst: [SINU_KONTEKST]"
Prompt 2: Testi mustand bugfixile
"Kirjuta sellele funktsioonile testi mustand.
Ära muuda äriloogikat.
Lisa edge case'id.
Kontekst: [SINU_KONTEKST]"
Prompt 3: PR kirjeldus
"Tee sellest diffist PR kirjeldus:
- mis muutus
- miks muutus
- kuidas testida
- mis on riskid
Kontekst: [SINU_KONTEKST]"
Prompt 4: Refaktori plaan
"Paku 3 väikest refaktori sammu, mida saab teha ilma arhitektuuri muutmata."Väga oluline: küsi AI-lt alati ka "mida ma peaksin käsitsi üle kontrollima?". Samuti tasub lisada, mis vastuse osad on ainult oletused.
5) Ohutu kasutus olemasolevas koodibaasis
Allolev tabel aitab vältida tüüpilisi algaja vigu. Seetõttu on seda kasulik kasutada ka tiimi ühtse reeglistikuna.
Kuigi reeglid tunduvad alguses jäigad, hoiavad need hiljem kokku palju aega ja närve.
| Tee nii | Ära tee nii |
|---|---|
| AI teeb mustandi, inimene kinnitab. | "Paste and merge" ilma üle vaatamata. |
| Sama testid + CI nagu varem. | AI-koodile erandid testidest ja review'st. |
| Kasuta AI-d väikestes ülesannetes. | Lase AI-l kohe suured moodulid ümber kirjutada. |
Kui see reegel on paigas, siis väheneb risk märgatavalt: AI aitab, aga kvaliteedistandard jääb samaks. Lisaks muutub ka onboarding lihtsamaks, sest uuel arendajal on selge mänguplaan ees.
6) 14 päeva plaan, mis toob tulemuse
Kui tahad kiiret, aga realistlikku algust, kasuta seda plaani. Seejärel võid plaani laiendada vastavalt tiimi kogemusele:
Teisalt ei pea kõiki samme tegema ideaalselt, sest ka osaline rakendamine annab tavaliselt esimese võidu.
- Päev 1: vali 2 kasutusjuhtu + pane kirja algne ajakulu.
- Päev 2-4: testi promptide starter kitti päris ülesannetel.
- Päev 5-7: jäta alles ainult promptid, mis annavad päris kasu.
- Päev 8-11: pane tiimi jaoks üks lihtne tööjuhend kirja.
- Päev 12-14: mõõda tulemus ja otsusta, mis jääb püsivalt kasutusse.
Mini-case (reaalne tüüpolukord):
- enne: PR kirjeldus 15-20 min;
- pärast: AI mustand 3-4 min + kontroll 3 min;
- võit: ~10 min iga PR pealt ilma kvaliteeti langetamata.
KKK algajale
Kas ma pean AI kasutamiseks olema ekspert? +
Ei pea. Alusta ühest lihtsast kasutusjuhust ja kasuta valmis prompti põhja. 80% kasust tuleb just lihtsatest korduvatest töödest. Lisaks kasvad kiiremini, kui teed seda järjepidevalt iga nädal.
Kas pean oma projekti ümber ehitama? +
Ei. Alusta AI kasutamisest dokumentatsiooni, testi mustandi ja PR kirjelduste jaoks. Tehniline integratsioon võib tulla hiljem. Seetõttu on algus väiksema riskiga ja lihtsam juhtida.
Mis siis, kui AI pakub valet lahendust? +
See on normaalne. AI vastus on mustand, mitte lõplik tõde. Kontrolli alati tulemusi ja hoia sama review ning testimise protsess nagu varem. Samuti dokumenteeri valed vastused, et prompti järgmine kord parandada.
Millal on õige hetk minna "advanced" tasemele? +
Siis, kui sul on juba 2-3 kasutusjuhtu, mis töötavad stabiilselt ja annavad aja kokkuhoidu. Enne seda keskendu lihtsale baasile.
Millal võtta appi töötuba või 1:1 tugi? +
Kui oled 2-3 nädalat katsetanud, aga töövoog ei stabiliseeru. Hea tugi aitab teha päris setupi sinu olemasoleva projekti peal, mitte ainult demo keskkonnas.
Järgmine samm
Soovid, et paneksime selle algaja stardiplaani sinu tiimis päriselt tööle?
Teeme koos konkreetse setupi: tööriista valik, promptide baas, mõõdikud ja tiimi protsess. Eesmärk on kiire väärtus, mitte lõputu katsetamine.
Kokkuvõttes saad süsteemi, mis on lihtne, mõõdetav ja päriselt kasutatav ka pärast esimest workshop'i.
Küsi AI stardikonsultatsiooni →SIA DESIGN
Disain ja veebiarendus
SIA DESIGN meeskond kirjutab praktilisi juhendeid veebidisaini, arenduse ja SEO teemadel.
Loe rohkem SIA DESIGN meeskonnast →
