Dejte agentovi užitečný kontext repozitáře

Začněte aktuální pracovní kopií

Agent musí vědět, který repozitář a větev mění. Musí také vědět, zda pracovní adresář obsahuje nesouvisející změny. Tyto skutečnosti ovlivňují, co může bezpečně upravit a jak má být konečný diff vykládán.

Požádejte agenta, aby před implementací prozkoumal pokyny projektu a konfiguraci balíčku. Příkaz zapamatovaný z jiného repozitáře zde může být nesprávný. Známý název frameworku neprokazuje nainstalovanou verzi ani konvence projektu.

Pro malou změnu poskytněte příslušný modul, volající kód, testy a architektonické rozhodnutí. Další informace přidejte, pokud šetření ukáže konkrétní potřebu.

Stabilní pravidla uložte do pokynů repozitáře

Soubor pokynů může popisovat podporované příkazy, hranice modulů, požadavky na kontrolu a akce vyžadující rozhodnutí odpovědné osoby. Konvence AGENTS.md dává programovacím nástrojům rozpoznatelné místo pro tyto informace. Podpora nástrojů a přednost pokynů se mohou lišit, proto ověřte chování svého nástroje.

Stabilní pravidla projektu uchovávejte v repozitáři. Aktuální úkol ponechte v zadání. Ze souboru pokynů nedělejte historii každé konverzace ani seznam dočasných plánů.

Užitečný pokyn zní: „Když cesta požadavku změní chování přístupu, spusť autorizační integrační testy.“ Vágní pokyn zní: „Vždy dávej pozor na bezpečnost.“ První určuje spouštěcí podmínku a akci, kterou kontrolující může ověřit.

Porovnejte pokyny s kódem

Pokyny zastarávají při změnách příkazů, adresářů nebo architektury. Pokud příručka uvádí chybějící skript, prozkoumejte konfiguraci balíčku. Pokud dokument tvrdí, že služba je pouze pro čtení, před spoléháním na toto tvrzení prověřte oprávnění.

Rozpor zaznamenejte. Pro pochopení chování implementace použijte přímé důkazy o aktuální verzi. Neodmítejte mlčky záměrné pravidlo jen proto, že je starý kód porušuje. Pravidlo a současné chování odpovídají na různé otázky.

Příručka například může zakazovat přímý zápis do sdílené větve, zatímco starý skript jej stále provádí. Správnou reakcí je zachovat pravidlo a opravit skript. Existující kód není oprávněním opakovat zakázanou akci.

Udržujte kontext relevantní a bezpečný

Celý repozitář může obsahovat přihlašovací údaje, soukromá testovací data, exporty zákazníků a staré logy podpory. Přístup do repozitáře automaticky neznamená, že je každý soubor vhodný pro službu modelu.

Používejte schválené nástroje a pravidla pro nakládání s daty. Z kontextu vylučte tajné údaje. Kde je to možné, nahraďte zákaznické příklady vymyšlenými daty. Vedle nahraných souborů prověřte i připojené nástroje: vyhledávací konektor může získat informace, které v původním promptu nikdy nebyly.

Pokyn repozitáře „nečti tajné údaje“ je užitečné vodítko. Nenahrazuje omezení přístupu k úložišti tajných údajů a citlivým adresářům.

Zanechte užitečný záznam pro dalšího člověka

Po dokončení zaznamenejte do pull requestu změněné chování, ověření a nevyřešená omezení. Při změně podporovaného postupu aktualizujte trvalou dokumentaci projektu. Nekopírujte do repozitáře celý přepis konverzace agenta.

Záznam má budoucímu správci pomoci práci zopakovat bez rekonstrukce dlouhé konverzace. Odkazujte na kanonické dokumenty a u každého stabilního pravidla udržujte jeden směrodatný popis.

Dobrý kontext omezuje opakované zkoumání. Usnadňuje také odhalení chyb, protože očekávané chování a funkční příkazy jsou výslovně uvedeny.