Dajte agentu koristan kontekst repozitorija

Počnite od trenutne radne kopije

Agent treba znati koji repozitorij i granu mijenja. Treba znati i sadrži li radni direktorij nepovezane promjene. Ove činjenice utječu na to šta može sigurno urediti i kako treba tumačiti konačnu razliku u kodu.

Tražite da agent pregleda projektne instrukcije i konfiguraciju paketa prije implementacije. Naredba koju pamti iz drugog repozitorija ovdje može biti pogrešna. Poznat naziv frameworka ne potvrđuje instaliranu verziju ni projektne konvencije.

Za malu promjenu dostavite relevantan modul, kod koji ga poziva, testove i arhitektonsku odluku. Dodajte više informacija kada istraga pokaže konkretnu potrebu.

Koristite instrukcije repozitorija za trajna pravila

Fajl s instrukcijama može opisati podržane naredbe, granice modula, zahtjeve pregleda i radnje koje traže odluku odgovorne osobe. Konvencija AGENTS.md daje alatima za kodiranje prepoznatljivo mjesto za ove informacije. Podrška alata i prvenstvo instrukcija mogu se razlikovati, pa provjerite ponašanje svog alata.

Držite trajna projektna pravila u repozitoriju. Trenutni zadatak držite u opisu zadatka. Nemojte pretvoriti fajl s instrukcijama u historiju svakog razgovora ili listu privremenih planova.

Korisna instrukcija kaže: „Izvršite integracijske testove autorizacije kada ruta mijenja ponašanje pristupa.“ Neodređena instrukcija kaže: „Uvijek pazite na sigurnost.“ Prva utvrđuje povod i radnju koje osoba zadužena za pregled može provjeriti.

Provjerite instrukcije prema kodu

Instrukcije zastarijevaju kada se promijene naredbe, direktoriji ili arhitektura. Ako vodič navodi skriptu koja nedostaje, pregledajte konfiguraciju paketa. Ako dokument kaže da usluga ima pristup samo za čitanje, pregledajte dozvole prije oslanjanja na tu tvrdnju.

Zabilježite sukob. Koristite neposredne dokaze o trenutnoj verziji da razumijete ponašanje implementacije. Nemojte prešutno odbaciti namjernu politiku zato što je stari kod krši. Politika i trenutno ponašanje odgovaraju na različita pitanja.

Naprimjer, vodič može zabraniti neposredno pisanje u zajedničku granu dok stara skripta to i dalje radi. Ispravan odgovor je sačuvati politiku i ispraviti skriptu. Postojeći kod nije dozvola za ponavljanje zabranjene radnje.

Neka kontekst bude relevantan i siguran

Cijeli repozitorij može sadržavati pristupne podatke, privatne testne podatke, izvoze podataka o klijentima i stare zapisnike podrške. Pristup repozitoriju ne znači automatski da je svaki fajl prikladan za uslugu modela.

Koristite odobrene alate i pravila obrade podataka. Isključite tajne iz konteksta. Zamijenite primjere klijenata izmišljenim podacima gdje je moguće. Provjerite povezane alate kao i učitane fajlove: konektor za pretragu može preuzeti informacije koje nikada nisu bile u početnom promptu.

Instrukcija repozitorija koja kaže „ne čitajte tajne“ korisna je smjernica. Ne zamjenjuje ograničavanje pristupa spremištu tajni i osjetljivim direktorijima.

Ostavite koristan zapis sljedećoj osobi

Po završetku zabilježite promijenjeno ponašanje, provjeru i neriješena ograničenja u zahtjevu za spajanje koda. Ažurirajte trajnu projektnu dokumentaciju kada se promijeni podržani radni tok. Izbjegavajte kopiranje cijelog transkripta rada agenta u repozitorij.

Zapis treba pomoći budućoj osobi zaduženoj za održavanje da ponovi rad bez rekonstruisanja dugog razgovora. Povežite kanonske dokumente i zadržite jedan mjerodavan opis svakog trajnog pravila.

Dobar kontekst smanjuje ponovljenu istragu. Olakšava i otkrivanje grešaka jer su očekivano ponašanje i ispravne naredbe izričito navedeni.