Дајте му корисен контекст од репозиториумот на агентот

Почнете со тековната работна копија

Агент треба да знае кој репозиториум и која гранка ги менува. Треба да знае и дали работниот директориум содржи неповрзани промени. Овие факти влијаат врз тоа што може безбедно да менува и како треба да се толкуваат конечните разлики.

Побарајте агентот да ги испита проектните инструкции и конфигурацијата на пакетот пред имплементацијата. Запомнета команда од друг репозиториум може да биде погрешна тука. Познато име на рамка не ја потврдува инсталираната верзија или проектните правила.

За мала промена, приложете го релевантниот модул, кодот што го повикува, тестовите и архитектонската одлука. Додавајте информации кога истражувањето ќе покаже конкретна потреба.

Користете инструкции во репозиториумот за трајни правила

Датотека со инструкции може да ги опише поддржаните команди, границите на модулите, барањата за преглед и дејствата што бараат одлука од одговорно лице. Конвенцијата AGENTS.md им дава на алатките за програмирање препознатливо место за овие информации. Поддршката во алатките и првенството на инструкциите може да се разликуваат, па проверете го однесувањето на вашата алатка.

Чувајте ги трајните проектни правила во репозиториумот. Чувајте ја тековната задача во нејзиниот опис. Не претворајте ја датотеката со инструкции во историја на секој разговор или список на привремени планови.

Корисна инструкција вели: „Извршете ги интеграциските тестови за авторизација кога рута го менува однесувањето на пристапот.“ Нејасна инструкција вели: „Секогаш внимавајте на безбедноста.“ Првата наведува повод и дејство што рецензент може да ги провери.

Проверете ги инструкциите според кодот

Инструкциите застаруваат кога се менуваат командите, директориумите или архитектурата. Ако водич именува скрипта што недостига, испитајте ја конфигурацијата на пакетот. Ако документ вели дека услуга е само за читање, проверете ги дозволите пред да се потпрете на тоа тврдење.

Запишете го несогласувањето. Користете директни докази за тековната верзија за да го разберете однесувањето на имплементацијата. Не отфрлајте молкум намерна политика затоа што стар код ја прекршува. Политиката и тековното однесување одговараат на различни прашања.

На пример, водичот може да забранува директно запишување во заедничка гранка, а стара скрипта сè уште да го прави тоа. Точниот одговор е да ја зачувате политиката и да ја поправите скриптата. Постоен код не е дозвола за повторување забрането дејство.

Одржувајте го контекстот релевантен и безбеден

Цел репозиториум може да содржи пристапни податоци, приватни тестни податоци, извезени податоци за клиенти и стари дневници од поддршката. Пристапот до репозиториумот не ја прави автоматски секоја датотека соодветна за услуга со модел.

Користете одобрени алатки и правила за обработка на податоци. Исклучете ги тајните од контекстот. Заменете ги примерите со клиенти со измислени податоци кога е можно. Проверете ги поврзаните алатки, не само поставените датотеки: конектор за пребарување може да прибере информации што никогаш не биле во првичната инструкција.

Инструкција во репозиториумот што вели „не читајте тајни“ е корисна насока. Не го заменува ограничувањето на пристапот до складиштето за тајни и чувствителните директориуми.

Оставете корисен запис за следното лице

По завршувањето, запишете ги изменетото однесување, проверките и нерешените ограничувања во барањето за спојување код. Ажурирајте ја трајната проектна документација кога се менува поддржаниот работен тек. Не копирајте го целиот разговор со агентот во репозиториумот.

Записот треба да му помогне на иден одржувач да ја повтори работата без да реконструира долг разговор. Поврзете ги канонските документи и задржете еден меродавен опис за секое трајно правило.

Добар контекст го намалува повтореното истражување. Ги прави и грешките полесни за откривање бидејќи очекуваното однесување и исправните команди се јасни.