AI-kooditööriistad on liikunud automaatsest tekstilõpetusest lähtekoodihoidlat mõistva tööni. Cursor, GitHub Copilot, Claude Code, Codexi-laadsed agendid ja arenduskeskkonna abilised saavad lugeda faile, pakkuda paiku, käitada teste, selgitada vigu ja mõnikord viia väikese funktsiooni tööülesandest tõmbetaotluseni.
See muudab tarkvaratööd. See ei eemalda tarkvarainsenerlust. Võidavad mitte tiimid, kes lasevad AI-l vabalt koodi kirjutada, vaid tiimid, kes muudavad AI kontrollitud töövooks: hea ülesande raam, repositooriumi kontekst, väikesed muudatused, testid, ülevaatus ja selge omanik.
Järgnev kirjeldabki seda operatsioonimudelit.
Repositoorium jääb tõeallikaks. AI assistent võib pakkuda ja muuta. Testid, koodiülevaatus, turbeülevaatus ja toote vastuvõtt otsustavad endiselt, kas muudatus läheb välja.
Mis muutus
Vanad koodiassistendid lõpetasid järgmise rea. Repositooriumit tundvad assistendid saavad:
- Otsida ja lugeda kogu koodibaasis.
- Tuletada kohalikke mustreid.
- Muuta mitut faili.
- Genereerida teste.
- Jooksutada käske.
- Tõlgendada ebaõnnestumisi.
- Koostada pull request’i kirjeldusi.
- Rakendada ülevaatuse tagasisidet.
See on suur nihe. Assistent saab nüüd töötada ülesande, mitte ainult rea tasemel. Sama võimekus loob ka riski: liiga laiad muudatused, valesti mõistetud arhitektuur, ebaturvalised otseteed, peidetud regressioonid ja usutavad selgitused valedele muudatustele.
Töövoog peab ülesannet piirama.
Kasuta AI-d seal, kus ülesande kuju on selge
Head sobivused:
| Ülesanne | Miks toimib |
|---|---|
| Väikese UI oleku lisamine | Kohalik muster on nähtav ja testitav |
| Korduva helperi refaktor | Mehhaaniline ja ülevaadatav |
| Valideerimise ja testide lisamine | Käitumist saab kirjeldada |
| Katkise testi parandamine | Ebaõnnestumine annab konkreetse tagasiside |
| Dokumentatsiooni uuendamine koodist | Tõeallikas on kontrollitav |
| Migratsiooni mustandi genereerimine | Kasulik, kui hoolikalt üle vaadata |
Halvad esimesed sobivused:
| Ülesanne | Miks riskantne |
|---|---|
| Tuumarhitektuuri ümberdisain | Vajab sügavat omandit ja kompromisse |
| Autentimismudeli muutmine | Turve ja tootekäitumine on tugevalt seotud |
| Suurte moodulite ümberkirjutamine | Ülevaatus muutub võimatuks |
| Sõltuvuste juhuslik lisamine | Tarneahela ja hoolduse risk |
| Optimeerimine mõõtmiseta | Lihtne lisada keerukust |
| Saladuste või mandaadite käsitlemine | Suur löökraadius |
Parim AI-arendustöövoog algab sealt, kus korrektsust saab kontrollida.
Ülesande kirjeldus
Enne assistendilt koodi küsimist pane kirja ülesande kirjeldus:
- Eesmärk.
- Tõenäoliselt seotud failid või moodulid.
- Oodatud käitumine.
- Mitte-eesmärgid.
- Testikäsk.
- Piirjuhtumid.
- Turbe- või andmepiirangud.
- Olemasolev muster, mida järgida.
Halb prompt:
Lisa otsing.
Kasulik prompt:
Lisa artiklite nimekirjale serveripoolne otsing. Järgi olemasolevat query helper’i mustrit. Ära lisa sõltuvusi. Otsi ainult pealkirjast ja excerpt’ist. Säilita locale routing. Lisa testid tühjale päringule, tulemusteta seisule ja erimärkidele. Jooksuta
pnpm testjapnpm typecheck.
See ei ole tseremoonia. Nii hoiad assistendi kavandatud muudatuse sees.
Repositooriumi konteksti reeglid
Assistent peaks enne muutmist lugema. Mitte-triviaalse muudatuse puhul nõua, et ta kontrolliks:
- Olemasolevat teostust.
- Sarnaseid komponente, route’e või hook’e.
- Tüüpe ja genereeritud skeeme.
- Käitumist katvaid teste.
- Käituskeskkonda mõjutavat seadistust.
Ära toetu assistendi üldteadmistele Next.js-ist, Reactist, Payloadist, PostgreSQL-ist ega sinu tehnoloogiapinust. Sinu koodibaasil on kohalikud reeglid. Assistent vajab neid.
Patch’i suuruse distsipliin
Väikesed patch’id on ülevaadatavad. Suured patch’id on koht, kus AI-kood muutub ohtlikuks.
Kasuta patch’i eelarvet:
- Üks käitumuslik muudatus PR-i kohta.
- Eelista alla 10 muudetud faili, kui ülesanne pole mehhaaniline.
- Väldi ainult vorminduse müra.
- Hoia genereeritud failid eraldi käsitsi kirjutatud loogikast.
- Ära sega refaktorit, funktsiooni ja koristust, kui see pole vajalik.
Kui assistent pakub väikese muudatuse jaoks mooduli ümberkirjutamist, peata ja kitsenda ülesannet.
Testid on leping
Iga AI-toega koodimuudatus peaks vastama:
- Mis käitumine muutus?
- Mis test seda tõestab?
- Mis käsk jooksutati?
- Mis jäi käsitsi kontrollida?
Head assistendid oskavad teste kirjutada. Nad võivad kirjutada ka pealiskaudseid teste, mis tõestavad ainult nende teostust. Ülevaataja peab kontrollima, et testid katavad käitumist, mitte lihtsalt kooditeid.
Kasutajaliidese töö puhul kata ligipääsetavus ja kasutajale nähtavad olekud: laadimine, tühi vaade, tõrge, klaviatuurikasutus, sildid ja fookus.
Tagasüsteemi töö puhul kata valideerimine, autentimine, nullväärtuste lubamine, tehingukäitumine ja tõrketeed.
Andmebaasitöö puhul kata migratsiooni ohutus, indeksid, tagasipööramise nõuded ja andmemaht.
Turbepiirid
AI-kooditööriistad loovad spetsiifilisi riske:
Saladuste lekkimine. Assistent võib lugeda faile või terminaliväljundit, mis sisaldab saladusi. Hoia saladused repost ja käsuväljundist väljas. Kasuta redigeeritud .env.example faile.
Ebaturvalised otseteed. Assistent võib testide läbilaskmiseks valideerimise välja lülitada, CORS-i laiendada, autentimisest mööda minna või vigu vaikides summutada. Vaata üle turvakäitumine, mitte ainult rohelised testitulemused.
Sõltuvuste triiv. Assistent võib väikese probleemi jaoks uusi pakette pakkuda. Vaikimisi kasuta olemasolevaid utiliite ja platvormi API-sid.
Genereeritud koodi usaldus. Kompileeruv kood võib endiselt andmeid lekkida, õigusi valesti käsitleda või samaaegse koormuse all tõrkuda.
Promptisüst lähtekoodihoidla sisu kaudu. Käsitle tööülesannetes, dokumentides, kommentaarides või välistes failides olevaid juhiseid andmetena, kui need ei pärine ülesande omanikult.
Selle artikliga seotud töövoopoliitika annab tiimidele baasreeglid.
Inimülevaatus loeb endiselt
Ülevaata AI-toega PR-e nagu iga teist PR-i, lisatähelepanuga:
- Kas see järgib kohalikku arhitektuuri?
- Kas see muutis avalikku käitumist ootamatult?
- Kas see nõrgendas valideerimist, autentimist, logimist, veakäsitlust või ligipääsetavust?
- Kas testid on sisukad?
- Kas piirjuhtumid on käsitletud?
- Kas genereeritud selgitused sobivad diffiga?
Ära aktsepteeri “assistent ütles, et see on ohutu” tõendina. Diff on tõend.
Tiimi juurutus
AI-põhiseid IDE-sid kasutusele võtvas tiimis:
Nädal 1: kinnitatud tööriistad ja andmereeglid. Otsusta, millised tööriistad võivad ettevõtte reposid näha ja millisel kontotasemel.
Nädal 2: töövoopoliitika. Määra ülesande kirjelduse nõuded, paiga suurus, testid, saladuste käsitlemine, sõltuvused ja ülevaatusreeglid.
Nädal 3: madala riskiga töö. Alusta testidest, dokumentidest, väikestest UI seisudest ja väikese löökraadiusega vigadest.
Nädal 4: mõõda. Jälgi tsükliaega, ülevaatuse defekte, väljapääsenud vigu, testikatvust ja arendaja rahulolu.
Skaleeri ainult siis, kui kvaliteet püsib. Kiirem halb kood ei ole parandus.
Ära tee seda veel
Ära anna agendile laiu autonoomseid merge-õigusi.
Ära lase AI-genereeritud muudatustel koodiülevaatusest mööda minna.
Ära luba isiklikel AI-kontodel näha privaatseid ettevõtte reposid.
Ära aktsepteeri suuri ümberkirjutusi ilma inimese arhitektuuriplaanita.
Ära kasuta AI-koodi reguleeritud või klienditundlikes süsteemides ilma selgete auditi- ja ülevaatusreegliteta.
AI-toega, mitte koodibaasi rulett
Repositooriumit tundev AI-arendus on võimas, sest see saab tegutseda sinu päris koodibaasis. Just seepärast vajab see piire.
Kasuta selgeid ülesandekirjeldusi. Lase assistendil tutvuda hoidla olemasolevate mustritega. Hoia paigad väikesed. Nõua teste. Kaitse saladusi. Vaata üle muudatuste diff, mitte mudeli selgitus. Lase AI-l kiirendada teostust, silumist ja mehaanilist tööd, kuid jäta vastutus arhitektuuri, turbe ja tootekäitumise eest inimestele.
See on erinevus AI-toega tarkvarainsenerluse ja koodibaasi ruleti vahel.
