Miten työskennellä kehittäjän kanssa tekoälyllä rakennetussa sovelluksessa

Tekoälyllä rakennetun sovelluksen kanssa sujuvasti toimiminen vaatii, että annat kehittäjälle koodin Git-repositoriossa, yhden sivun yhteenvedon siitä, mitä sovellus tekee ja miksi, sekä selkeästi rajatun tehtävän ja määritelmän valmiudelle. Sopikaa, kuka muuttaa mitäkin, jotta sinä ja tekoäly ette ylikirjoita hänen työtään. Pidä repositorio ja hostauksen tilit omalla nimelläsi ja jaa salaisuudet asianmukaisissa asetuksissa, ei viesteissä.

Moni rakentaa ensimmäisen version sovelluksesta tekoälyllä ja tuo sitten kehittäjän mukaan — lisäämään maksut, korjaamaan jotain, mitä tekoäly toistuvasti tekee väärin, tarkistamaan tietoturvan tai ottamaan vastuun, kun sovellus kasvaa. Jos mietit vielä, palkkaisiko kehittäjän ollenkaan, katso palkkaa kehittäjä tai rakenna tekoälyllä. Tämä opas olettaa, että olet päättänyt, ja haluat yhteistyön sujuvan.

Milloin kehittäjä kannattaa

Yleisiä syitä tuoda joku mukaan:

• Ongelma, jonka tekoäly ei ratkaise, vaikka olet yrittänyt selkeillä kehotteilla ja palautuksilla useita kertoja.
• Riskialttiit alueet: maksut, käyttöoikeudet, arkaluonteiset tiedot, tietokannan migraatiot.
• Tietoturva- tai koodikatselmointi ennen julkaisua tai ennen suurempia asiakkaita.
• Suorituskyky, kun oikeaa liikennettä alkaa tulla.
• Kasvu: sovelluksesta on tullut liiketoiminta, ja se tarvitsee jonkun, joka omistaa koodin.

Se, mikä näistä on kyseessä, muokkaa kaikkea alla olevaa.

Vaihe 1: Vie koodi paikkaan, jonka voi jakaa

Kehittäjät työskentelevät Git-repositorioista. Ennen kuin otat yhteyttä kehen tahansa:

1. Yhdistä projekti yksityiseen GitHub- (tai vastaavaan) repositorioon tai vie se.
2. Varmista, ettei koodissa tai historiassa ole salaisuuksia. Katso miten pidät API-avaimet turvassa.
3. Tarkista, että projekti käynnistyy tuoreesta kopiosta. Pyydä tekoälyä kirjoittamaan asennusvaiheet.

Kirjoita README kehittäjälle, joka liittyy tähän projektiin: mitä sovellus tekee, mitä pinoa se käyttää, miten se asennetaan ja käynnistetään paikallisesti, mitä ympäristömuuttujia se tarvitsee (vain nimet), kansiorakenne ja kaikki hauras tai epätavallinen.

Jos Git on sinulle uusi, miten käyttää Gitiä tekoälyllä rakennetun sovelluksen kanssa kertoo perusteet.

Vaihe 2: Kirjoita yhden sivun toimeksianto

Kehittäjä ei ole ollut mukana chat-historiassasi. Anna hänelle konteksti yhdellä sivulla:

• Mitä sovellus tekee, kenelle ja kuinka monta ihmistä sitä käyttää.
• Mikä on tärkeintä — kulkuja, joiden ei koskaan saa hajota.
• Tunnetut ongelmat ja mitä olet jo kokeillut.
• Tehtävä ja se, miten tiedät sen olevan valmis.
• Rajoitteet: budjetti, aikataulu, asiat, joita ei saa muuttaa.

Hyvä „valmiuden määritelmä” on testattavissa: „Kirjautunut käyttäjä voi maksaa kuukausipaketista Stripe Checkoutilla, paketti näkyy hänen tilisivullaan, ja asiakasportaalissa peruminen palauttaa hänet alemmalle tasolle jakson lopussa.” Ei „hoida maksut”.

Vaihe 3: Anna pääsy turvallisesti

• Koodi: lisää kehittäjä repositorion yhteistyökumppaniksi. Älä lähettele ZIP-tiedostoja edestakaisin, kun työ on alkanut.
• Rakentaja: jos tekoälyrakentajasi tukee tiimin jäseniä, kutsu hänet työtilaan, joka sisältää vain tämän projektin.
• Salaisuudet: lisää ne palvelusi asetuksiin tai jaa salasanahallinnan kautta. Älä liitä avaimia sähköpostiin tai chattiin.
• Testitilit: luo ne testidatalla sen sijaan, että jakaisit oman kirjautumisesi.
• Tuotantodata: vain jos hän todella tarvitsee sitä, ja vain sen, minkä tarvitsee.

Pidä repositorio, verkkotunnus ja hostauspalvelujen tilit omalla nimelläsi. Lisää ihmisiä; älä luovuta tilejä.

Vaihe 4: Sopikaa, kuka muuttaa mitä

Suurin kitka syntyy siitä, että kaksi osapuolta — sinä tekoälyn kanssa ja kehittäjä — muuttavat samaa koodia samaan aikaan. Valitse sääntö:

Valitsitpa minkä tahansa: hae uusin koodi ennen jokaista kehotteistuntoa ja tee suuret muutokset haaroissa, jotka toinen voi tarkistaa.

Vaihe 5: Viesti kirjallisesti

• Raportoi ongelmat vaiheilla, odotetuilla ja todellisilla tuloksilla. Katso miten kirjoittaa hyvä bugiraportti.
• Pidä päätökset yhdessä paikassa: ongelmanseurantatyökalussa, jaetussa dokumentissa tai vetopyyntöjen kommenteissa.
• Pyydä, että hän selittää muutokset selkeästi jokaisessa vetopyynnössä.
• Sopikaa, kuinka usein tarkistatte tilanteen.

Vaihe 6: Tarkista hänen työnsä

Koodin lukeminen ei ole välttämätöntä työn tarkistamiseen. Tarkista:

• Se tekee sen, mitä toimeksiannossa sanottiin, esikatselu- tai testikopiossa.
• Mikään muu ei hajonnut — aja kriittiset kulut läpi.
• Hän selitti, mitä muutti ja miksi.
• Koodissa ei ole salaisuuksia.

Tarkempaan katseluun miten tarkistaa tekoälyn tuottama koodi sisältää tarkistuslistan, joka toimii myös ihmisen kirjoittamalle koodille. Voit myös pyytää tekoälyrakentajaa selittämään kehittäjän vetopyynnön sinulle yksinkertaisin sanoin.

Vaihe 7: Pidä omistajuus selkeänä

• Repositorio, hostaus, verkkotunnus ja kolmannen osapuolen tilit pysyvät sinulla.
• Kirjaa kirjallisesti, kenelle kuuluu hänen kirjoittamansa koodi, ennen kuin työ alkaa. Tarkista sopimuskysymykset paikallisten sääntöjen tai neuvonantajan kanssa.
• Kun työ päättyy, poista hänen pääsynsä ja vaihda kaikki avaimet, jotka hän näki.

Esimerkkikehotteet

Kehittäjä muutti kassakoodia viimeisessä muutoksessa. Selitä yksinkertaisin sanoin, mitä hän muutti ja onko sovelluksen muilla osilla riippuvuutta siitä.

Listaa tämän sovelluksen monimutkaisimmat ja riskialttiimmat osat, jotta voin kertoa kehittäjälle, mihin katselmoinnissa keskittyä.

Siirrän maksut kehittäjälle. Älä koske mihinkään tiedostoon kohdassa src/payments tai /api/billing-reiteillä tästä eteenpäin. Jos muutos vaatii niitä, kerro minulle sen sijaan.

Yleisiä virheitä

• Ei toimeksiantoa. Kehittäjä käyttää maksettuja tunteja sen selvittämiseen, mitä halusit.
• Epämääräinen laajuus kuten „korjaa bugit” tai „tee tuotantovalmis”.
• Molemmat muokkaavat yhtä aikaa ilman hakemista ensin, jolloin työ katoaa ristiriitoihin.
• Oman tilin jakaminen tai avainten liittäminen chattiin.
• Tilit kehittäjän nimellä, mikä vaikeuttaa eroamista.
• Käyttöoikeuden poistamisen unohtaminen ja avainten vaihtamisen unohtaminen työn jälkeen.

Tarkistuslista

• Koodi on yksityisessä repositoriossa omalla nimelläni, eikä siinä ole salaisuuksia.
• README selittää asennuksen; yhden sivun toimeksianto selittää sovelluksen ja tehtävän.
• Tehtävällä on testattava valmiuden määritelmä.
• Pääsy annetaan yhteistyökutsuilla ja salaisuudet asetusten tai salasanahallinnan kautta.
• Olemme sopineet, kuka muuttaa mitä, ja haen ennen kehotteen antamista.
• Työ tarkistetaan toimeksiantoa ja kriittisiä kulkuja vastaan.
• Omistajuus on kirjattu; pääsy poistetaan ja avaimet vaihdetaan työn päättyessä.

Yhteistyö kehittäjän kanssa Mythexillä

• Kutsu hänet työtilaan. Omistajat voivat kutsua rajattoman määrän yhteistyökumppaneita ilman paikkamaksuja, ja jäsenet työskentelevät työtilan projekteissa. Käytä erillistä työtilaa, jotta hän näkee vain tämän projektin. Julkaistujen sovellusten krediitit laskutetaan työtilan omistajalle. Katso Kutsut.
• GitHub-synkronointi ja vienti (Pro). Yhdistä repositorio ja työnnä tai hae muutoksia tai vie projekti ilman salaisuuksia. Katso GitHub, vienti ja tuonti.
• Jaa esikatselulinkki, kun näytät keskeneräisen työn henkilölle ilman Mythex-tiliä, ja poista se, kun olet valmis.
• Kysymystila vastaa kysymyksiin koodista muuttamatta sitä. Se on hyödyllinen kehittäjän muutosten ymmärtämiseen.

Jos kehittäjä ajaa sovelluksen muualla, katso miten viedä tekoälyllä rakennettu sovellus ja ajaa se itse.

Kysymykset