Dajte agentovi užitočný kontext repozitára

Začnite aktuálnou pracovnou kópiou

Agent potrebuje vedieť, ktorý repozitár a vetvu mení. Potrebuje tiež vedieť, či pracovný adresár obsahuje nesúvisiace zmeny. Tieto fakty ovplyvňujú, čo môže bezpečne upravovať a ako treba vykladať konečný diff.

Požiadajte agenta, aby pred implementáciou preskúmal pokyny projektu a konfiguráciu balíkov. Zapamätaný príkaz z iného repozitára tu môže byť nesprávny. Známy názov frameworku nepreukazuje nainštalovanú verziu ani konvencie projektu.

Pri malej zmene poskytnite relevantný modul, volajúci kód, testy a architektonické rozhodnutie. Ďalšie informácie pridajte, keď skúmanie ukáže konkrétnu potrebu.

Stabilné pravidlá uložte do pokynov repozitára

Súbor s pokynmi môže opisovať podporované príkazy, hranice modulov, požiadavky na kontrolu a akcie vyžadujúce rozhodnutie zodpovednej osoby. Konvencia AGENTS.md poskytuje programovacím nástrojom rozpoznateľné miesto pre tieto informácie. Podpora nástrojov a priorita pokynov sa môžu líšiť, preto overte správanie svojho nástroja.

Stabilné pravidlá projektu uchovávajte v repozitári. Aktuálnu úlohu uchovávajte v zadaní. Zo súboru s pokynmi nerobte históriu každej konverzácie ani zoznam dočasných plánov.

Užitočný pokyn znie: „Keď route mení správanie prístupu, spustite integračné testy autorizácie.“ Neurčitý pokyn znie: „Vždy dávajte pozor na bezpečnosť.“ Prvý určuje spúšťaciu podmienku a akciu, ktorú možno overiť.

Porovnajte pokyny s kódom

Pokyny zastarávajú pri zmene príkazov, adresárov alebo architektúry. Ak sprievodca uvádza chýbajúci skript, preskúmajte konfiguráciu balíka. Ak dokument tvrdí, že služba je iba na čítanie, pred spoľahnutím sa na toto tvrdenie preskúmajte oprávnenia.

Zaznamenajte rozpor. Správanie implementácie zisťujte z priamych dôkazov o aktuálnej verzii. Neodmietnite potichu zámernú politiku preto, že ju starý kód porušuje. Politika a aktuálne správanie odpovedajú na rôzne otázky.

Sprievodca napríklad môže zakazovať priamy zápis do zdieľanej vetvy, zatiaľ čo starý skript ho stále vykonáva. Správnou reakciou je zachovať politiku a opraviť skript. Existujúci kód nie je oprávnením zopakovať zakázanú akciu.

Udržujte kontext relevantný a bezpečný

Celý repozitár môže obsahovať prihlasovacie údaje, súkromné testovacie dáta, exporty zákazníkov a staré logy podpory. Prístup k repozitáru automaticky neznamená, že je každý súbor vhodný pre službu modelu.

Používajte schválené nástroje a pravidlá spracovania údajov. Z kontextu vylúčte tajné údaje. Ak je to možné, nahraďte zákaznícke príklady vymyslenými údajmi. Overte pripojené nástroje aj nahrané súbory. Vyhľadávací konektor môže získať informácie, ktoré nikdy neboli v pôvodnom prompte.

Pokyn repozitára „nečítajte tajné údaje“ je užitočným usmernením. Nenahrádza obmedzenie prístupu k úložisku tajných údajov a citlivým adresárom.

Zanechajte užitočný záznam pre ďalšiu osobu

Po dokončení zaznamenajte v pull requeste zmenené správanie, overenie a nevyriešené obmedzenia. Keď sa zmení podporovaný pracovný postup, aktualizujte trvalú projektovú dokumentáciu. Nekopírujte do repozitára celý prepis konverzácie s agentom.

Záznam má budúcemu správcovi pomôcť zopakovať prácu bez rekonštruovania dlhej konverzácie. Odkazujte na kanonické dokumenty a zachovajte jeden záväzný opis každého stabilného pravidla.

Dobrý kontext znižuje opakované skúmanie. Uľahčuje aj odhaľovanie chýb, pretože očakávané správanie a funkčné príkazy sú výslovné.