Kako delati z razvijalcem na aplikaciji, ustvarjeni z AI

Da dobro sodelujete z razvijalcem pri aplikaciji, ustvarjeni z AI, mu dajte kodo v repozitoriju Git, enostranski povzetek, kaj aplikacija počne in zakaj, ter jasno omejeno nalogo z opredeljenim pojmom »končano«. Dogovorite se, kdo spreminja kateri del, da vi in AI ne prepišete njegovega dela, repozitorij in račune za gostovanje vodite na svoje ime, skrivnosti pa delite prek ustreznih nastavitev, ne prek sporočil.

Veliko ljudi prvo različico aplikacije zgradi z AI in nato pripelje razvijalca – da doda plačila, popravi nekaj, kar AI nenehno pokvari, pregleda varnost ali prevzame aplikacijo, ko ta raste. Če se še odločate, ali sploh najeti razvijalca, glejte najem razvijalca ali gradnja z AI. Ta vodnik predpostavlja, da ste se odločili in želite, da sodelovanje poteka gladko.

Kdaj se razvijalec splača

Pogosti razlogi, da koga pripeljete:

• Težava, ki je AI ne zmore rešiti po več jasnih poskusih in povratkih.
• Tvegana področja: plačila, dovoljenja, občutljivi podatki, selitve baze podatkov.
• Varnostni ali kodni pregled pred lansiranjem ali pred večjimi strankami.
• Zmogljivost, ko pride pravi promet.
• Rast: aplikacija je postala posel in potrebuje nekoga, ki odgovarja za kodo.

Jasnost o tem, za kateri namen gre, oblikuje vse spodaj.

1. korak: kodo postavite na mesto, kjer jo je mogoče deliti

Razvijalci delajo iz repozitorijev Git. Preden koga kontaktirate:

1. Projekt povežite z zasebnim repozitorijem na GitHubu (ali podobni storitvi) ali ga izvozite.
2. Poskrbite, da v kodi ali zgodovini ni skrivnosti. Glejte kako varno hraniti ključe API.
3. Preverite, ali projekt deluje s svežo kopijo – AI naj napiše korake namestitve.

Napiši README za razvijalca, ki se pridružuje temu projektu: kaj aplikacija počne, uporabljeni sklad, kako jo namestiti in zagnati lokalno, katere spremenljivke okolja potrebuje (samo imena), strukturo map in vse, kar je krhko ali nenavadno.

Če vam je Git nov, kako uporabljati Git z aplikacijo, ustvarjeno z AI pokrije osnove.

2. korak: napišite enostranski povzetek

Razvijalec ni sedel ob vašem klepetu. Dajte mu kontekst na eni strani:

• Kaj aplikacija počne, za koga in koliko ljudi jo uporablja.
• Kaj je najpomembnejše – tokovi, ki se nikoli ne smejo pokvariti.
• Znane težave in kaj ste že poskusili.
• Naloga in kako boste vedeli, da je opravljena.
• Omejitve: proračun, rok, stvari, ki jih ne sme spreminjati.

Dobra »definicija končanega« je preverljiva: »Prijavljen uporabnik lahko plača mesečni paket prek Stripe Checkout, paket se prikaže na njegovi strani računa, preklic v portalu za stranke pa ga na koncu obdobja zniža.« Ne pa »uredi plačila«.

3. korak: varno omogočite dostop

• Koda: razvijalca dodajte kot sodelavca v repozitorij. Ko se delo začne, ne pošiljajte datotek ZIP sem ter tja.
• Graditelj: če vaš graditelj aplikacij z AI podpira člane ekipe, jih povabite v delovni prostor, ki vsebuje samo ta projekt.
• Skrivnosti: dodajte jih v nastavitve gostitelja ali jih delite prek upravitelja gesel. Ključev nikoli ne prilepite v e-pošto ali klepet.
• Testni računi: ustvarite jih s testnimi podatki, namesto da delite svoj račun.
• Produkcijski podatki: samo če jih res potrebujejo in samo tiste, ki jih potrebujejo.

Repozitorij, domeno in račune za gostovanje imejte na svoje ime. Dodajajte ljudi; računov ne izročajte.

4. korak: dogovorite se, kdo kaj spreminja

Najpogostejši vir trenj sta dve strani – vi z AI in razvijalec –, ki hkrati spreminjata isto kodo. Izberite pravilo:

Ne glede na izbiro: pred vsako sejo poziva povlecite najnovejšo kodo in večje spremembe izvajajte na vejah, ki jih lahko pregleda druga oseba.

5. korak: komunicirajte pisno

• Napake prijavljajte s koraki ter pričakovanim in dejanskim rezultatom. Glejte kako napisati dobro poročilo o napaki.
• Odločitve hranite na enem mestu: v sledilniku težav, v skupnem dokumentu ali v komentarjih zahtevkov za združitev.
• Od njega zahtevajte, da v vsakem zahtevku za združitev spremembe razloži s preprostimi besedami.
• Dogovorite se, kako pogosto se bosta oglasila.

6. korak: pregledajte njegovo delo

Za pregled dela ne potrebujete branja kode. Preverite:

• Ali deluje, kot je pisalo v povzetku, na predogledu ali na kopiji za testiranje.
• Ali se ni nič drugega pokvarilo – preizkusite svoje ključne tokove.
• Ali je razložil, kaj je spremenil in zakaj.
• Ali se v kodi niso pojavile skrivnosti.

Za natančnejši pogled je kako pregledati kodo, ki jo ustvari AI s kontrolnim seznamom, ki velja tudi za kodo, napisano ročno. Svojega graditelja z AI lahko tudi prosite, naj vam zahtevek za združitev razvijalca razloži preprosto.

7. korak: jasno določite lastništvo

• Repozitorij, gostovanje, domena in računi tretjih oseb ostanejo vaši.
• Lastništvo kode, ki jo napiše, zapišite pisno, preden se delo začne. Vprašanja o pogodbi preverite z lokalnimi pravili ali svetovalcem.
• Ko se delo konča, mu odvzemite dostop in zamenjajte vse ključe, ki jih je videl.

Primeri pozivov

Razvijalec je v zadnjem zahtevku spremenil kodo za blagajno. Z jasnimi besedami razloži, kaj je spremenil, in ali je kaj drugega v aplikaciji odvisno od tega.

Naštej dele te aplikacije, ki so najbolj zapleteni ali tvegani, da lahko razvijalcu povem, kje naj se osredotoči pri pregledu.

Plačila predajam razvijalcu. Od zdaj naprej se ne dotikaj datotek pod src/payments ali poti /api/billing. Če sprememba zahteva njihovo spremembo, mi to povej namesto tega.

Pogoste napake

• Brez povzetka. Razvijalec plačane ure porabi za ugibanje, kaj ste želeli.
• Nejasen obseg, kot »popravi napake« ali »naredi pripravljeno za produkcijo«.
• Oba urejata hkrati brez povleka, nato se delo izgubi zaradi konfliktov.
• Deljenje lastnega prijavnega računa ali lepljenje ključev v klepet.
• Računi na ime razvijalca, zaradi česar je ločitev težka.
• Pozaba na odvzem dostopa in zamenjavo ključev po koncu dela.

Kontrolni seznam

• Koda je v zasebnem repozitoriju na moje ime, brez skrivnosti.
• README razloži namestitev; enostranski povzetek razloži aplikacijo in nalogo.
• Naloga ima preverljivo definicijo končanega.
• Dostop je prek povabil sodelavcev, skrivnosti prek nastavitev ali upravitelja gesel.
• Dogovorili smo se, kdo kaj spreminja, in pred pozivom povlečem kodo.
• Delo je pregledano glede na povzetek in ključne tokove.
• Lastništvo je zapisano; ob koncu dela je dostop odvzet in ključi zamenjani.

Delo z razvijalcem na Mythexu

• Povabite ga v delovni prostor. Lastniki lahko povabijo neomejeno število sodelavcev brez mesečnih pristojbin za sedeže; člani delajo na projektih delovnega prostora. Uporabite ločen delovni prostor, da vidi samo ta projekt. Krediti za objavljene aplikacije se obračunajo lastniku delovnega prostora. Glejte Povabila.
• Sinhronizacija z GitHubom in izvoz (Pro). Povežite repozitorij in potiskajte/povlačite spremembe ali izvozite projekt brez skrivnosti. Glejte GitHub, izvoz in uvoz.
• Delite povezavo za predogled, da nekomu brez računa Mythex pokažete delo v teku; ko končate, jo izbrišite.
• Način vprašanj odgovarja na vprašanja o kodi, ne da bi jo spremenil – uporaben za razumevanje sprememb razvijalca.

Če bo razvijalec aplikacijo zaganjal drugje, glejte kako izvoziti in samostojno gostiti aplikacijo, ustvarjeno z AI.

Vprašanja