Adjon az agentnek hasznos repozitárkontextust

Induljon ki az aktuális checkoutból

Az agentnek tudnia kell, melyik repozitárt és ágat módosítja. Azt is tudnia kell, hogy a munkakönyvtár tartalmaz-e más feladathoz tartozó változtatásokat. Ezek határozzák meg, mit szerkeszthet biztonságosan, és hogyan kell értelmezni a végső diffet.

Kérje meg az agentet, hogy a megvalósítás előtt vizsgálja meg a projekt utasításait és csomagkonfigurációját. Egy másik repozitárból felidézett parancs itt hibás lehet. Az ismerős frameworknév nem bizonyítja a telepített verziót vagy a projekt konvencióit.

Kis módosításhoz adja át a releváns modult, annak hívóit, a teszteket és az architekturális döntést. Akkor adjon további információt, ha a vizsgálat konkrét igényt mutat.

A tartós szabályokat rögzítse a repozitár utasításaiban

Az utasításfájl leírhatja a támogatott parancsokat, a modulhatárokat, a review-követelményeket és a felelősi döntést igénylő műveleteket. Az AGENTS.md konvenció felismerhető helyet biztosít ezeknek az információknak a programozási eszközök számára. A konvenció támogatása és az utasítások prioritása eszközönként eltérhet, ezért ellenőrizze saját eszköze működését.

A tartós projektszabályokat tartsa a repozitárban. Az aktuális feladatot tartsa a feladatleírásban. Az utasításfájlt ne alakítsa minden beszélgetés történetévé vagy ideiglenes tervek listájává.

Hasznos utasítás: „Futtassa a jogosultsági integrációs teszteket, ha egy route módosítása érinti a hozzáférés működését.” Homályos utasítás: „Mindig ügyeljen a biztonságra.” Az első konkrét kiváltó feltételt és ellenőrizhető műveletet ad meg.

Vesse össze az utasításokat a kóddal

Az utasítások elavulnak, ha a parancsok, könyvtárak vagy az architektúra változnak. Ha az útmutató hiányzó szkriptet nevez meg, vizsgálja meg a csomagkonfigurációt. Ha egy dokumentum szerint egy szolgáltatás csak olvasási hozzáféréssel működik, a jogosultságok ellenőrzése előtt ne támaszkodjon erre az állításra.

Rögzítse az ellentmondást. A megvalósítás működésének megértéséhez használjon közvetlen bizonyítékot az aktuális verzióról. Ne hagyjon figyelmen kívül egy tudatos szabályt csak azért, mert a régi kód megsérti. A szabályzat és a jelenlegi működés különböző kérdésekre ad választ.

Az útmutató például tilthatja a közös ágra történő közvetlen írást, miközben egy régi szkript továbbra is ezt teszi. A helyes lépés a szabály megtartása és a szkript javítása. A meglévő kód nem engedély a tiltott művelet megismétlésére.

A kontextus maradjon releváns és biztonságos

A teljes repozitár tartalmazhat hitelesítő adatokat, bizalmas tesztadatokat, ügyfélexportokat és régi támogatási logokat. A repozitárhoz való hozzáférés nem jelenti automatikusan, hogy minden fájl átadható egy modellszolgáltatásnak.

Használjon jóváhagyott eszközöket és adatkezelési szabályokat. A titkokat zárja ki a kontextusból. Az ügyfélpéldákat lehetőség szerint cserélje kitalált adatokra. A kapcsolt eszközöket is vizsgálja meg, ne csak a feltöltött fájlokat. Egy keresési connector olyan információt is lekérhet, amely nem szerepelt az eredeti promptban.

A „ne olvasson titkokat” repozitárutasítás hasznos útmutatás. Nem helyettesíti a titoktárolókhoz és érzékeny könyvtárakhoz való hozzáférés korlátozását.

Hagyjon használható nyilvántartást a következő munkatársnak

A feladat végén a pull requestben rögzítse a megváltozott működést, az ellenőrzéseket és a fennmaradó korlátokat. Ha a támogatott munkafolyamat változik, frissítse a tartós projektdokumentációt. Ne másolja az agent teljes beszélgetésnaplóját a repozitárba.

A nyilvántartás segítse a későbbi karbantartót a munka megismétlésében hosszú beszélgetés rekonstruálása nélkül. Hivatkozzon a mérvadó dokumentumokra, és minden tartós szabálynak egy hiteles leírása legyen.

A jó kontextus csökkenti az ismételt vizsgálatot. A hibák felismerését is megkönnyíti, mert az elvárt működés és a működő parancsok egyértelműek.