Create tasks, docs, plans, and so much more with ClickUp MCP

Claude Code-utasítások: 25 másolásra kész utasítás és útmutató a saját utasítások írásához

Megkéred a Claude Code-ot, hogy javítsa ki egy fizetési hibát. A program módosítja a megfelelő fájlt, és jelenti, hogy a tesztek sikeresek voltak. De a tesztek nem fedték le azt a lejárt kupont, amely a hibát okozta, így továbbra sem tudod, hogy a javítás működik-e.

Egy hasznos utasítás elegendő információt ad a Claude Code-nak ahhoz, hogy pótolja ezt a hiányosságot: a várt viselkedést, a releváns fájlokat, a módosításra vonatkozó esetleges korlátokat, valamint az ellenőrizhető bizonyítékokat. Hiba kijavítása esetén ez azt jelentheti, hogy a kód módosítása előtt reprodukálni kell a hibát. Kódbázissal kapcsolatos kérdés esetén pedig azt jelentheti, hogy meg kell nevezni a válasz alapjául szolgáló fájlokat és függvényeket.

Az alábbi 25 Claude Code-feladat a tervezést, a hibakeresést, a kódfelülvizsgálatot, a migrációkat és egyéb visszatérő feladatokat fedi le. Mindegyik kiindulási pontot nyújt a saját kódtárához való igazításhoz, útmutatással arra vonatkozóan, hogy mit kell megadni, és hogyan kell értékelni az eredményt.

Összefoglalás: Adjon meg a Claude Code-nak egy pontosan meghatározott feladatot, a megfelelő repository-kontextust, valamint egyértelmű korlátokat arra vonatkozóan, hogy mi változhat. Kódmódosítások esetén határozzon meg teszteket vagy egyéb ellenőrzéseket; kutatás és tervezés esetén kérjen hivatkozott eredményeket vagy áttekinthető tervet. Igazítsa a 25 sablont a projekt követelményeihez és jogosultságaihoz, majd a munka elfogadását megelőzően ellenőrizze a bizonyítékokat.

Miben különbözik egy Claude Code-utasítás egy csevegőprogram-utasítástól?

A Claude Code-parancs nem csupán magyarázatot kér, hanem engedélyezheti a munkavégzést a kódtárban. Az eszközöktől és a jogosultságoktól függően a Claude képes fájlokat ellenőrizni, parancsokat futtatni, kódot szerkeszteni és az eredményeket ellenőrizni. Ezért az utasításoknak mind a feladatot, mind a munka határait meg kell határoznia.

A csevegőasszisztensek is használhatnak eszközöket és hajthatnak végre műveleteket, így a különbség nem abban áll, hogy „a csevegőasszisztens válaszol, a Claude Code pedig cselekszik”. A gyakorlati különbség a környezetben és a hozzáférésben rejlik, amelyet az asszisztensnek biztosítasz. Ha a csevegőben javasolt javítást kérsz, annak alkalmazása rajtad múlik; ha viszont a Claude Code-ot kéred meg a javítás végrehajtására, az megváltoztathatja a munkafájljaidat.

Ez megváltoztatja a nem egyértelmű kérés következményeit. A „Fix checkout” kérés nem tisztázza a hatókört, a várt viselkedést és az elfogadható változtatásokat. Előfordulhat, hogy a Claude egy hihető megvalósítást állít elő, amelyet aztán Önnek kell ellenőriznie vagy visszavonnia. Egy hasznosabb kérés meghatározza a hibás esetet, azt, hogy mi maradjon változatlan, és hogy a Claude-nak vizsgálódnia, terveznie vagy szerkesztenie kell-e.

AspectA csevegőt tanácsadásra vagy kódvázlatok készítésére használjukA Claude Code működése egy kódtárban
Mit tesz lehetővé a kérésMagyarázat vagy javasolt kód, amelyet értékelhet és alkalmazhatFájlok ellenőrzése, parancsok és szerkesztések a rendelkezésre álló eszközök és jogosultságok segítségével
Elérhető kontextusA beszélgetés, a mellékelt fájlok és az összes kapcsolódó forrásRepozitóriumi fájlok, vonatkozó projektutasítások és kapcsolódó eszközök
A nem egyértelmű kérés következményeiNem megfelelő válasz vagy javasolt megvalósításOlyan változtatások, amelyek esetleg nem felelnek meg a követelményeknek, vagy nem kapcsolódó kódot érintenek
Hogyan irányítod a munkátFinomítsd a kérdést, és döntsd el, mit használj!Határozza meg a hatókört, válasszon engedélyezési módot, és vizsgálja át a terveket és a változtatásokat
Hasznos bizonyítékok a kérelemhezForrások, feltételezések vagy a javasolt kód magyarázataKapcsolódó fájlhivatkozások, diffek, tényleges teszt eredmények és megoldatlan problémák

Az Anthropic által 500 000 kódolással kapcsolatos interakció elemzése szemlélteti ezt a használati különbséget. A 2025. áprilisi adatok alapján a Claude Code-beszélgetések 79%-át automatizálásnak minősítette, szemben a Claude.ai-beszélgetések 49%-ával. Ezek a számok a megfigyelt használati mintákat írják le, nem pedig a két termékre vonatkozó rögzített korlátokat.

Ugyanez a tanulmány a Claude Code-val való interakciók 35,8%-át visszacsatolási ciklusként osztályozta, amelyekben az emberek validálták a munkát, és további információkat szolgáltattak, például hibaüzeneteket. Ha Claude-nak releváns tesztparancsot adsz, az segíthet neki a hibák közvetlen kivizsgálásában. Továbbra is meg kell vizsgálnod, hogy ezek az ellenőrzések lefedik-e a kért viselkedést.

A Claude Code esetében az utasításnak egyértelműen meg kell határoznia a kívánt cselekvés szintjét: magyarázza el a kódot, javasoljon változtatást, vagy hajtsa végre azt egy meghatározott hatókörön belül. Állítsa be a jogosultságokat külön, majd vizsgálja meg az adott feladathoz tartozó bizonyítékokat.

Profi tipp: Ha még mindig kódolási eszközöket hasonlítasz össze, nézd meg a Claude Code vs. Copilot és a Claude vs. ChatGPT című cikkeket a kódolásról. Böngészőalapú parancsokhoz használd a Claude AI parancsok útmutatóját. Ha először beállítási útmutatásra van szükséged, kezdd a Claude Code használatának bemutatásával.

A jó Claude Code-utasítás felépítése

Egy jól megfogalmazott Claude Code-parancs leírja a kívánt eredményt, az annak előállításához szükséges kontextust, valamint azt, hogy hogyan fogod értékelni a munkát. Egy adott függvényre vonatkozó kérdéshez esetleg csak egy fájlhivatkozásra és a kért magyarázatra van szükség. Több fájlt érintő változtatáshoz viszont egyértelműbb hatókörre és korlátozásokra van szükség.

Adja meg az alábbi hat részletet, ahol azok relevánsak:

  • Mi: A várt viselkedés, például érvénytelen kuponra vonatkozó üzenet megjelenítése a fizetési hiba visszaadása helyett
  • Hol: A hatály alá tartozó fájlok, mappák vagy szolgáltatások, amelyekre @ jelöléssel hivatkozol, ha ismered őket
  • Minta: Egy meglévő megvalósítás, amelyet a Claude-nak követnie kell, például a projekted API-kliensének vagy a hiba kezelésére vonatkozó konvencióknak.
  • Ellenőrzés: A kódmódosításokhoz tartozó teszt- vagy összeállítási parancs, illetve a kutatáshoz szükséges fájlhivatkozások és commit-azonosítók
  • Korlátok: Mi az, amit érintetlenül kell hagyni, például a nyilvános API-k, az adatbázis-sémák vagy a nem kapcsolódó modulok
  • Megközelítés: Claude-nak magyarázatot kell adnia, felülvizsgálati tervet kell javasolnia, vagy végre kell hajtania a változtatást?

Íme, hogyan javítják ezek a részletek három gyakori feladatot.

Javítson ki egy konkrét hibát

Ahelyett, hogy: „Javítsd ki a checkout hibát.”

A lejárt kupont használó ügyfelek 500-as hibakódot kapnak a fizetés során. Vizsgálja meg az @src/checkout/coupons.ts fájlt és a hozzá tartozó teszteket. A várt viselkedés egy „érvénytelen kupon” üzenet megjelenése a megrendelés létrehozása nélkül. Írjon egy sikertelen tesztet, amely reprodukálja a hibát, majd javítsa ki anélkül, hogy megváltoztatná az érvényes kuponok viselkedését. Futtassa a [checkout test parancsot], és mutassa be az eredményeket a javítás előtt és után. Ha nem tudja reprodukálni a hibát, jelentse, mit ellenőrizte, mielőtt módosította volna az implementációt.

A lejárt kupont használó ügyfelek 500-as hibakódot kapnak a fizetés során. Vizsgálja meg az @src/checkout/coupons.ts fájlt és a hozzá tartozó teszteket. A várt viselkedés egy „érvénytelen kupon” üzenet megjelenése a megrendelés létrehozása nélkül. Írjon egy sikertelen tesztet, amely reprodukálja a hibát, majd javítsa ki anélkül, hogy megváltoztatná az érvényes kuponok viselkedését. Futtassa a [checkout test parancsot], és mutassa be az eredményeket a javítás előtt és után. Ha nem tudja reprodukálni a hibát, jelentse, mit ellenőrizte, mielőtt módosította volna az implementációt.

Adjon hozzá egy funkciót egy meglévő minta felhasználásával

Ahelyett, hogy: „Adjon hozzá egy dátumválasztót.”

Adjon hozzá egy dátumválasztót a [foglalási űrlap elérési útjához]. Kövesse a @src/components/TimeSelect.tsx fájlban található komponens- és érvényesítési konvenciókat. A felhasználóknak lehetőségük kell legyen a [megengedett dátumok] kiválasztására, míg a [nem elérhető dátumok] továbbra is letiltva maradnak. Ne adjon hozzá könyvtárakat. Futtassa a [komponens teszt parancsot] és a [típusellenőrző parancsot], és jelentsen minden olyan kritériumot, amelyet ezek az ellenőrzések nem fednek le.

Adjon hozzá egy dátumválasztót a [foglalási űrlap elérési útjához]. Kövesse a @src/components/TimeSelect.tsx fájlban található komponens- és érvényesítési konvenciókat. A felhasználóknak lehetőségük kell legyen a [megengedett dátumok] kiválasztására, míg a [nem elérhető dátumok] továbbra is letiltva maradnak. Ne adjon hozzá könyvtárakat. Futtassa a [komponens teszt parancsot] és a [típusellenőrző parancsot], majd jelentsen minden olyan kritériumot, amelyet ezek az ellenőrzések nem fednek le.

Refaktorálás a viselkedés megváltoztatása nélkül

Ahelyett, hogy: „Tisztítsd meg ezt a fájlt.”

Oszd fel az @src/reports/export.py fájlt kisebb függvényekre úgy, hogy megőrizd a bemeneteit, a kimeneti formátumot és a hiba kezelését. A szerkesztés előtt futtasd le az [export test command] parancsot, és jelentsd be az esetleges hibákat. Az átalakítás után futtasd le újra a teszteket, és mutasd be mindkét eredményt. Ne módosítsd a nyilvános felületet vagy a nem kapcsolódó fájlokat.

Oszd fel az @src/reports/export.py fájlt kisebb függvényekre úgy, hogy megőrizd a bemeneteit, a kimeneti formátumot és a hiba kezelését. A szerkesztés előtt futtasd le az [export test command] parancsot, és jelentsd az esetleges hibákat. Az átalakítás után futtasd le újra a teszteket, és mutasd be mindkét eredményt. Ne módosítsd a nyilvános felületet vagy a nem kapcsolódó fájlokat.

Cserélje ki a példában szereplő útvonalakat és parancsokat a saját repositoryjából származó értékekre. A sikeresen teljesített tesztek bizonyítékul szolgálnak az általuk lefedett esetekre; vizsgálja át a diff-et, és győződjön meg arról, hogy az esetek megfelelnek a követelményeknek.

Ezek a példák az Anthropic Claude Code legjobb gyakorlataiban szereplő, hatókörrel ellátott kérések megközelítését alkalmazzák. A kódoláson túlmutató útmutatásért tekintse meg ezeket az AI-ügynököknek szóló legjobb gyakorlatokat.

Miért fontosabb az ellenőrzés, mint a megfogalmazás?

Még egy részletes utasítás is olyan kódot eredményezhet, amely nem a megfelelő problémát oldja meg. Megadhatja ugyan a fájlokat, a kódolási stílust és a kívánt kimenetet, de kihagyhatja azt a feltételt, amely meghatározza, hogy a változtatás hasznos-e. Egy lejárt kuponhoz kapcsolódó hiba esetében a „a pénztárnál végzett tesztek sikeresek” kijelentés nem elégséges bizonyíték, hacsak azok a tesztek nem fedik le a hibás kupont, és nem erősítik meg, hogy nem jött létre megrendelés.

A megfogalmazás segít Claude-nak megérteni a kérést. Az ellenőrzés lehetővé teszi, hogy felmérje, vajon a megvalósítás megfelel-e a kérésnek. Ez a különbségtétel akkor fontos, amikor Claude fájlokat szerkeszthet és parancsokat futtathat: a változás meggyőző magyarázata nem bizonyítja, hogy a viselkedés helyes.

Az Anthropic Claude Code legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy biztosítsunk lehetőséget a Claude-nak munkájának ellenőrzésére tesztek, képernyőképek vagy várt kimenetek segítségével. Az ellenőrzésnek tükröznie kell a követelményt. A build ellenőrzi, hogy a projekt lefordul-e; egy célzott teszt egy adott viselkedést ellenőrzi; a képernyőképek összehasonlítása segít a megjelenített felület értékelésében. Mindegyik egy-egy különböző kérdésre ad választ.

Boris Cherny, a Claude Code megalkotója, leírja, hogyan használja a böngészőalapú visszacsatolási ciklust a saját munkamenetében:

„A Claude a Claude Chrome-bővítmény segítségével minden egyes változtatást tesztel, amit az claude.ai/code oldalra feltöltök. Megnyit egy böngészőt, teszteli a felhasználói felületet, és addig ismételgeti a folyamatot, amíg a kód működik és a felhasználói élmény kellemesnek tűnik. ”

„A Claude a Claude Chrome-bővítmény segítségével minden egyes változtatást tesztel, amit az claude.ai/code oldalra feltöltök. Megnyit egy böngészőt, teszteli a felhasználói felületet, és addig ismételgeti a folyamatot, amíg a kód működik és a felhasználói élmény kellemesnek tűnik. ”

Az InfoQ Cherny munkamenetéről szóló beszámolója szerint ő úgy véli, hogy az ellenőrzés két-háromszorosára javíthatja az eredmények minőségét. Ez a munkamenetére vonatkozó becslés, nem pedig kontrollált mérés vagy garantált javulás.

Vállaljon felelősséget a követelményekért és az átvételi kritériumokért

A megvalósítás delegálása ellenére továbbra is Ön felel azért, hogy eldöntse, mit kell a szoftvernek csinálnia. A Claude javasolhat teszteket, de ezeknek a teszteknek tükrözniük kell az Ön üzleti szabályait, beleértve azokat a kivételeket is, amelyek a kódból nem feltétlenül derülnek ki.

Körülbelül 400 000 Claude Code-munkamenet elemzése során az Anthropic megállapította, hogy az emberek a tervezési döntések mintegy 70%-át hozták meg, de a végrehajtási döntéseknek csak körülbelül 20%-át. A tanulmány azt is kimutatta, hogy a feladatspecifikus szakértelem magasabb szintje összefüggésbe hozható a magasabb igazolt sikerarányokkal: a kezdő szintűnek minősített munkamenetek esetében ez körülbelül 15% volt, míg a középhaladó vagy szakértői szintű munkamenetek esetében 28–33%.

Ezeknek az adatoknak kontextusra van szükségük. A szakértelmet a beszélgetési jegyzőkönyvek alapján értékelték, a „megerősített siker” pedig a munkamenet során elért siker bizonyítékát igényelte. Az Anthropic nem figyelte meg a felhasználók valós eredményeit. Azok a munkamenetek, amelyeknél ez a jel nem volt jelen, nem feltétlenül voltak sikertelenek, és a tanulmány nem állapítja meg, hogy pusztán az utasítások megfogalmazásának megváltoztatása önmagában javítaná az eredményeket.

A gyakorlati következménye ennek az, hogy hozzá kell járulnunk azokhoz a ismeretekhez, amelyeket a Claude nem tud biztonságosan kikövetkeztetni. Egy számlákat egyeztető könyvelőnek meg kell határoznia, hogyan kell kezelni a részleges befizetéseket, a visszatérítéseket és a kerekítéseket. Egy fizetési folyamat viselkedését módosító fejlesztőnek meg kell határoznia, mely meglévő viselkedésmódok maradjanak változatlanok. Ezek a döntések határozzák meg, hogy a kapott tesztek a megfelelő dolgokat ellenőrzik-e.

Mielőtt elfogadna egy változtatást, közösen vizsgálják át a követelményt, a megvalósítást és a bizonyítékokat. Kérdezze meg, mely eseteket tesztelték, mely ellenőrzések sikertelenek voltak vagy kimaradtak, és mi maradt bizonytalan. Ez alapot ad a munka elfogadásához, túlmutatva azon, hogy Claude kijelenti: a munka befejeződött.

25 Claude Code-feladat, amelyet lemásolhat és saját igényeihez igazíthat

Válasszon egy utasítást a elvégzendő feladat alapján, majd cserélje ki a zárójelben szereplő részleteket a saját repositoryjának elérési útjaival, követelményeivel és parancsaival. Kódmódosítások esetén adjon meg egy teszt- vagy összeállítási parancsot. Kutatás és tervezés esetén kérjen forráshivatkozásokat és egy egyértelműen meghatározott eredményt.

Ezek a sablonok leírják, milyen feladatot szeretne Claude-ra bízni. A Claude Code jogosultságait külön kell beállítani; egy olyan utasítás, mint például a „ne szerkeszd a fájlokat”, nem helyettesíti a hozzáférés-vezérlést.

Segítség a kódbázis megértéséhez

Mielőtt ismeretlen kódot módosítanál, derítsd ki, hol található a releváns viselkedés, és hogyan működik. Ezek a feladatok a fájlok és a történet olvasására összpontosítanak, szerkesztés nélkül.

1. Ismerje meg az ismeretlen kódtár áttekintését

Használd ezt, amikor csatlakozol egy projekthez, vagy először dolgozol egy kódtárban. Kezdd a README-vel, a projektkonfigurációval és a könyvtárszerkezettel, ahelyett, hogy megkérnéd Claude-ot, hogy olvassa el az összes fájlt.

Vizsgálja meg a README fájlt, a projektkonfigurációt és a tárház legfelső szintű könyvtárszerkezetét. Csak annyira hivatkozzon a forrásokra, amennyire az a következőket magyarázni szükséges: mit csinál az alkalmazás; melyek a fő belépési pontjai és főbb összetevői; hol találhatók a tesztek, és mely parancsokat határozza meg a tárház azok futtatásához. Hivatkozzon a magyarázatát alátámasztó fájlútvonalakra. Különítse el a dokumentált viselkedést a saját következtetéseitől, és jelölje meg mindazt, amit nem tud megállapítani. Ne olvassa el a titkos vagy környezeti fájlokat, ne vizsgálja meg a telepített függőségeket, és ne módosítson semmilyen fájlt. Zárásként sorolja fel azt a három fájlt, amelyet először el kellene olvasnom, és indokolja meg, miért.

Vizsgálja meg a README fájlt, a projektkonfigurációt és a tárház legfelső szintű könyvtárszerkezetét. Csak annyira hivatkozzon a forrásokra, amennyire az a következőket magyarázni szükséges: mit csinál az alkalmazás; melyek a fő belépési pontjai és főbb összetevői; hol találhatók a tesztek, és mely parancsokat határozza meg a tárház azok futtatásához. Hivatkozzon a magyarázatát alátámasztó fájlútvonalakra. Különítse el a dokumentált viselkedést a saját következtetéseitől, és jelölje meg mindazt, amit nem tud megállapítani. Ne olvassa el a titkos vagy környezeti fájlokat, ne vizsgálja meg a telepített függőségeket, és ne módosítson semmilyen fájlt. Zárásként sorolja fel azt a három fájlt, amelyet először el kellene olvasnom, és indokolja meg, miért.

2. Ismerje meg, miért változott egy implementáció

Használd a Git előzményeit egy tervezési döntés kivizsgálásához, mielőtt azt kicserélnéd. Kérj dokumentált bizonyítékot, ahelyett, hogy feltételeznéd, hogy a jelenlegi kód tükrözi az eredeti szerző szándékát.

Tekintse át a [fájl, függvény vagy osztály] Git-előzményeit, különös figyelmet fordítva a [viselkedésre vagy tervezési kérdésre]. Azonosítsa azokat a commitokat, amelyek bevezették vagy jelentősen megváltoztatták ezt a viselkedést. Minden releváns commit esetében adja meg annak hash-értékét, foglalja össze a változást, és magyarázza el a commit üzenetben vagy a hozzáférhető kapcsolódó beszélgetésben dokumentált indokokat. A következtetett okokat jelölje meg „következtetésként”. Ha az előzmények nem magyarázzák a döntést, jelezze ezt. Ne módosítsa a fájlokat vagy a Git-előzményeket.

Tekintse át a [fájl, függvény vagy osztály] Git-előzményeit, különös figyelmet fordítva a [viselkedésre vagy tervezési kérdésre]. Azonosítsa azokat a commitokat, amelyek bevezették vagy jelentősen megváltoztatták ezt a viselkedést. Minden releváns commit esetében adja meg annak hash-értékét, foglalja össze a változást, és magyarázza el a commit üzenetben vagy a hozzáférhető kapcsolódó beszélgetésben dokumentált indokokat. A következtetett okokat jelölje meg „következtetésként”. Ha az előzmények nem magyarázzák a döntést, jelezze ezt. Ne módosítsa a fájlokat vagy a Git-előzményeket.

3. Egy adott alkalmazás folyamatának nyomon követése

Használja ezt, mielőtt olyan, több komponenst érintő viselkedéshez nyúlna, mint például a hitelesítés, a fizetés vagy az értesítések.

Kövesse nyomon, mi történik, amikor [felhasználói művelet vagy rendszeresemény] bekövetkezik, [ismert útvonal, kezelő vagy mappa] kiindulási ponttól kezdve. Kövesse nyomon a releváns hívásokat az érvényesítésen, az üzleti logikán, valamint az esetleges adatbázis-írásokon és külső kéréseken keresztül. Sorolja fel a fájlokat és függvényeket végrehajtási sorrendben, amennyiben lehetséges, sorhivatkozásokkal együtt. Magyarázza el a főbb hibaútvonalakat, és azonosítsa a folyamatot lefedő meglévő teszteket. Jelölje meg azokat a kapcsolatokat, amelyeket a kódból nem tud megerősíteni. Ne hajtsa végre a folyamatot, ne hívjon meg külső szolgáltatásokat, és ne szerkesszen fájlokat.

Kövesse nyomon, mi történik, amikor [felhasználói művelet vagy rendszeresemény] történik, kezdve [ismert útvonal, kezelő vagy mappa] ponttól. Kövesse nyomon a releváns hívásokat az érvényesítésen, az üzleti logikán, valamint az esetleges adatbázis-írásokon és külső kéréseken keresztül. Sorolja fel a fájlokat és függvényeket végrehajtási sorrendben, amennyiben lehetséges, sorhivatkozásokkal együtt. Magyarázza el a főbb hibaútvonalakat, és azonosítsa a folyamatot lefedő meglévő teszteket. Jelölje meg azokat a kapcsolatokat, amelyeket a kódból nem tud megerősíteni. Ne hajtsa végre a folyamatot, ne hívjon meg külső szolgáltatásokat, és ne szerkesszen fájlokat.

Utasítások a fejlesztés megkezdése előtti tervezéshez

Azoknál a változtatásoknál, amelyek több fájlt érintenek, vagy fontos követelményeket hagynak megoldatlanul, a megvalósítás előtt vizsgálja át a tervet. Ezek a tippek segítenek a munka meghatározásában, a döntések tisztázásában és az érintett kód azonosításában.

4. Tervezze meg a funkciót, mielőtt módosítaná a kódot

Használd ezt akkor, ha ismered a kívánt viselkedést, de meg kell értened a megvalósítást. Indulj a Tervezés módban, hogy Claude átvizsgálhassa a kódtárat, mielőtt változtatásokat javasolna.

Tervezd meg, hogyan valósítsd meg a [funkciót] a [repozitórium területén]. A várt viselkedés a következő: [követelmények], és ezek a területek változatlanok maradnak: [korlátozások]. Vizsgáld át a vonatkozó kódot és a meglévő teszteket. Határozd meg a módosítandó fájlokat, a megvalósítás sorrendjét, valamint az esetleges kompatibilitási vagy adatmigrációs kockázatokat. Rendeld hozzá az egyes követelményeket egy javasolt teszthez vagy más ellenőrzési lépéshez. A megoldatlan kérdéseket és feltételezéseket külön sorold fel. Még ne valósítsa meg a funkciót. Küldje vissza a tervet, hogy átnézzem.

Tervezd meg, hogyan valósítsd meg a [funkciót] a [repozitórium területén]. A várt viselkedés a következő: [követelmények], és ezek a területek változatlanok maradnak: [korlátozások]. Vizsgáld át a vonatkozó kódot és a meglévő teszteket. Határozd meg a módosítandó fájlokat, a megvalósítás sorrendjét, valamint az esetleges kompatibilitási vagy adatmigrációs kockázatokat. Rendeld hozzá az egyes követelményeket egy javasolt teszthez vagy más ellenőrzési lépéshez. A megoldatlan kérdéseket és feltételezéseket külön sorold fel. Még ne valósítsa meg a funkciót. Küldje vissza a tervet, hogy átnézzem.

5. A specifikáció megírása előtt tisztázza a követelményeket

Használja ezt akkor, ha a funkciókérés nem ad választ a felhasználói viselkedéssel, az adatokkal vagy a szélsőséges esetekkel kapcsolatos döntésekre. Az így elkészült specifikációnak elegendő kontextust kell nyújtania a későbbi megvalósítási munkához.

[Felhasználók és felhasználási eset] számára szeretnék létrehozni egy [rövid leírás] alkalmazást. Először olvassa el a [vonatkozó fájlokat vagy követelményeket], majd az AskUserQuestion segítségével tisztázza azokat a döntéseket, amelyek lényegesen befolyásolhatják a megvalósítást. Fókuszáljon a szélsőséges esetekre, az adatkezelésre, a jogosultságokra, a várt felhasználói felületi viselkedésre és a kompromisszumokra. Ne tegyen fel olyan kérdéseket, amelyekre a megadott kontextus már választ ad. Miután a legfontosabb döntések megszülettek, készítsen egy specifikációt, amely tartalmazza a követelményeket, az átvételi kritériumokat, a korlátozásokat és azt, hogy mi nem tartozik a hatály alá. Jelölje meg az esetleges fennmaradó feltételezéseket. Mutassa meg nekem a specifikációt, mielőtt elmenti a [specifikáció elérési útja] helyre, és ne írja felül a meglévő fájlt jóváhagyás nélkül.

[Felhasználók és felhasználási eset] számára szeretnék létrehozni egy [rövid leírás] alkalmazást. Először olvassa el a [vonatkozó fájlokat vagy követelményeket], majd az AskUserQuestion segítségével tisztázza azokat a döntéseket, amelyek lényegesen befolyásolhatják a megvalósítást. Fókuszáljon a szélsőséges esetekre, az adatkezelésre, a jogosultságokra, a várt felhasználói felületi viselkedésre és a kompromisszumokra. Ne tegyen fel olyan kérdéseket, amelyekre a megadott kontextus már választ ad. Miután a legfontosabb döntések megszülettek, készítsen egy specifikációt, amely tartalmazza a követelményeket, az átvételi kritériumokat, a korlátozásokat és azt, hogy mi nem tartozik a hatály alá. Jelölje meg az esetleges fennmaradó feltételezéseket. Mutassa meg nekem a specifikációt, mielőtt elmenti a [specifikáció elérési útja] helyre, és ne írja felül a meglévő fájlt jóváhagyás nélkül.

Miután áttekintette és elmentette a specifikációt, hivatkozzon rá a megvalósítási munkamenet során. Adja meg a vonatkozó repository-útvonalakat, hogy a Claude összehasonlíthassa a specifikációt a meglévő kóddal.

6. Határozza meg, mire hathat ki egy megosztott kód módosítása

Használja ezt, mielőtt megváltoztatna egy megosztott függvényt, komponenst vagy interfészt. A hívók listája segít felmérni a hatókört, de előfordulhat, hogy nem tárja fel a tárolón kívüli felhasználókat.

Mérje fel, milyen hatással jár, ha a [függvényt, komponenst vagy interfészt] a [jelenlegi viselkedésről] a [javasolt viselkedésre] változtatja. Keresse meg a [repozitórium vagy könyvtár hatókörében] annak definícióját, közvetlen hívóit, importjait és a kapcsolódó teszteket. Sorolja fel azokat a fájlokat, amelyeknél valószínűleg módosításokra lesz szükség, és magyarázza el, hogy azok hogyan érinthetők, amennyiben lehetséges, fájl- és sorhivatkozásokkal. Jelölje meg a dinamikusan feloldott hívásokat, a külső felhasználókat vagy más olyan függőségeket, amelyeket nem tud ellenőrizni. Azonosítsa azokat a kompatibilitási kérdéseket, amelyekre a megvalósítás előtt választ kell adni. Ne módosítsa a fájlokat; küldje el a hatáselemzést, és várja meg az én áttekintésemet.

Mérje fel, milyen hatással jár, ha a [függvényt, komponenst vagy interfészt] a [jelenlegi viselkedésről] a [javasolt viselkedésre] változtatja. Keresse meg a [repozitórium vagy könyvtár hatókörében] annak definícióját, közvetlen hívóit, importjait és a kapcsolódó teszteket. Sorolja fel azokat a fájlokat, amelyeknél valószínűleg módosításokra lesz szükség, és magyarázza el, hogy azok hogyan érinthetők, amennyiben lehetséges, fájl- és sorhivatkozásokkal. Jelölje meg a dinamikusan feloldott hívásokat, a külső felhasználókat vagy más olyan függőségeket, amelyeket nem tud ellenőrizni. Azonosítsa azokat a kompatibilitási kérdéseket, amelyekre a megvalósítás előtt választ kell adni. Ne módosítsa a fájlokat; küldje el a hatáselemzést, és várja meg az én áttekintésemet.

Utasítások funkciók fejlesztéséhez

A funkciók fejlesztésére vonatkozó utasításoknak le kell írniuk a várt viselkedést, és össze kell kapcsolniuk azt a projektben már meglévő kóddal. Foglaljon bele releváns példákat, korlátozásokat és ellenőrzéseket, hogy Claude a változást úgy tudja végrehajtani, hogy ne hozzon a feladattal összefüggésbe nem hozható döntéseket.

7. Készítsen el egy funkciót egy meglévő minta felhasználásával

Használd ezt akkor, ha a repository-ban már létezik egy hasonló funkció. Mutass rá a Claude-nak arra a megvalósításra, amelyet követnie kell, beleértve az adat-hozzáférést, a hiba-kezelést és a teszteket is.

Adja hozzá a [funkciót] a [fájlhoz vagy oldalhoz] a következő viselkedéssel: [elfogadási kritériumok]. Vizsgálja meg a [meglévő megvalósítást], és kövesse annak konvencióit az adatok lekérésére, a hibakezelésre és a komponensek szervezésére vonatkozóan. Csak a projektbe már telepített könyvtárakat használja. Tartsa a változtatásokat a [határon] belül, és őrizze meg a [meglévő viselkedést vagy nyilvános felületet]. Adjon hozzá vagy frissítsen teszteket az elfogadási kritériumokhoz. Futtassa a [tesztparancsot] és a [típusellenőrző vagy lint parancsot], majd jelentse a megváltozott fájlokat, az eredményeket és az összes olyan ellenőrzést, amelyet nem tudott végrehajtani. Ha a meglévő minta ütközik egy követelménnyel, magyarázza el az ütközést, mielőtt továbbhaladna.

Adja hozzá a [funkciót] a [fájlhoz vagy oldalhoz] a következő viselkedéssel: [elfogadási kritériumok]. Vizsgálja meg a [meglévő megvalósítást], és kövesse annak konvencióit az adatok lekérésére, a hibakezelésre és a komponensek szervezésére vonatkozóan. Csak a projektbe már telepített könyvtárakat használja. Tartsa a változtatásokat a [határon] belül, és őrizze meg a [meglévő viselkedést vagy nyilvános felületet]. Adjon hozzá vagy frissítsen teszteket az elfogadási kritériumokhoz. Futtassa a [tesztparancsot] és a [típusellenőrző vagy lint parancsot], majd jelentse a megváltozott fájlokat, az eredményeket és az összes olyan ellenőrzést, amelyet nem tudott végrehajtani. Ha a meglévő minta ütközik egy követelménnyel, magyarázza el az ütközést, mielőtt továbbhaladna.

8. Írj teszteket a függvény megvalósítása előtt

Használd ezt olyan viselkedés esetén, amelyet meghatározott bemenetek és kimenetek segítségével tudsz kifejezni. A teszt kezdeti kudarca inkább a hiányzó viselkedést kell, hogy mutassa, nem pedig a hibás tesztbeállítást.

Végrehajtja a [függvény neve] függvényt a [fájl] fájlban a [követelmények] teljesítése érdekében. Foglalja le a [normál eset], a [határ eset] és az [érvénytelen bemeneti viselkedés] eseteket. Először futtassa le a [vonatkozó tesztparancsot], és jelentse az esetleges hibákat. Írjon teszteket a kért viselkedéshez, majd futtassa le őket a megvalósítás előtt. Győződjön meg arról, hogy az új tesztek a várt okból buknak meg. Végrehajtja a függvényt, majd futtassa le újra a teszteket. Ne gyengítse az állításokat, ne hagyjon ki teszteket, és ne módosítsa a várt viselkedést csak azért, hogy a tesztek sikeresek legyenek. Ha a követelmények ütköznek a meglévő tesztekkel, álljon meg, és magyarázza el az ütközést. Mutassa be az „előtte” és „utána” eredményeket.

Végrehajtja a [függvény neve] függvényt a [fájl] fájlban a [követelmények] teljesítése érdekében. Foglalja le a [normál eset], a [határ eset] és az [érvénytelen bemeneti viselkedés] eseteket. Először futtassa le a [vonatkozó tesztparancsot], és jelentse az esetleges hibákat. Írjon teszteket a kért viselkedéshez, majd futtassa le őket a megvalósítás előtt. Győződjön meg arról, hogy az új tesztek a várt okból buknak meg. Végrehajtja a függvényt, majd futtassa le újra a teszteket. Ne gyengítse az állításokat, ne hagyjon ki teszteket, és ne módosítsa a várt viselkedést azért, hogy a tesztek sikeresek legyenek. Ha a követelmények ütköznek a meglévő tesztekkel, álljon meg, és magyarázza el az ütközést. Mutassa be az „előtte” és „utána” eredményeket.

9. Vezessen be egy felhasználói felületet egy referencia-kép alapján

Használd ezt, ha rendelkezésedre áll egy tervezési képernyőkép és egy működőképes módszer a megvalósítás rögzítésére. Add meg az útvonalat, a nézőteret és a felhasználói felület állapotát, hogy a Claude összehasonlíthassa az egyenértékű képernyőket.

Végrehajtja a mellékelt tervet a [komponensben vagy oldalon], a projekt meglévő komponenseinek és stílusainak felhasználásával. Megőrzi a [szükséges viselkedést], és elkerüli a [határon] kívüli változtatásokat. Használja a [beállított böngészőt vagy képernyőkép-készítő eszközt] a [helyi útvonal] rögzítéséhez a [nézőtér méreteinél], a [tesztadatokkal és a felhasználói felület állapotával] együtt. Ha az eszköz vagy az alkalmazás nem áll rendelkezésre, jelentse be, mire van szükség, ahelyett, hogy vizuális ellenőrzést igényelne. Hasonlítsa össze a rögzített képet a referenciaképpel, különös figyelmet fordítva az [elrendezésre, térközökre, tipográfiára vagy egyéb elfogadási kritériumokra]. Végezzen legfeljebb [szám] javítási köröket, majd jelentse a fennmaradó eltéréseket. Ne módosítsa a referenciaképet. Futtassa a [vonatkozó komponens teszteket] és a [típusellenőrzést vagy a build parancsot]. Foglalja bele az összefoglalójába a rögzített képernyőképet és a tényleges ellenőrzési eredményeket.

Végrehajtja a mellékelt tervet a [komponensben vagy oldalon], a projekt meglévő komponenseinek és stílusainak felhasználásával. Megőrzi a [szükséges viselkedést], és elkerüli a [határon] kívüli változtatásokat. Használja a [beállított böngészőt vagy képernyőkép-készítő eszközt] a [helyi útvonal] rögzítéséhez a [nézőtér méreteinél], a [tesztadatokkal és a felhasználói felület állapotával] együtt. Ha az eszköz vagy az alkalmazás nem áll rendelkezésre, jelentse be, mire van szükség, ahelyett, hogy vizuális ellenőrzést igényelne. Hasonlítsa össze a rögzített képet a referenciaképpel, különös figyelmet fordítva az [elrendezésre, térközökre, tipográfiára vagy egyéb elfogadási kritériumokra]. Végezzen legfeljebb [szám] javítási köröket, majd jelentse a fennmaradó eltéréseket. Ne módosítsa a referenciaképet. Futtassa a [vonatkozó komponens teszteket] és a [típusellenőrzést vagy a build parancsot]. Foglalja bele az összefoglalójába a rögzített képernyőképet és a tényleges ellenőrzési eredményeket.

Utasítások a hibakereséshez és a hibajavításhoz

Adja meg Claude-nak a megfigyelt hibát, a várt viselkedést és a már rendelkezésre álló bizonyítékokat. Egy reprodukálható példa segít megkülönböztetni a bejelentett probléma kijavítását attól a módosítástól, amely csupán eltávolítja a hibaüzenetet.

10. A hiba kijavítása előtt reprodukálja azt

Használja ezt, ha le tudja írni, mi váltja ki a hibát. Csatoljon releváns naplóbejegyzéseket vagy példaadatokat, a hitelesítő adatok és az érzékeny adatok eltávolítása mellett.

A felhasználók [tünetet] tapasztalnak, amikor [kiváltó ok vagy bemenet] történik. A várt viselkedés [várt eredmény]. Kezdje azzal, hogy megvizsgálja a [mappát, függvényt vagy folyamatot] és a kapcsolódó teszteket. Hozzon létre egy sikertelen tesztet, amely reprodukálja a jelentett viselkedést. Ha nem tudja reprodukálni, magyarázza el, mit ellenőrizte és milyen információk hiányoznak, mielőtt módosítaná a megvalósítást. A reprodukálás után javítsa ki az okot anélkül, hogy megváltoztatná a [megmaradnia kellő viselkedést]. Futtassa az új tesztet és a [kapcsolódó tesztparancsot]. Mutassa be a javítás előtti hibát, az azt követő eredményeket és az esetleges fennmaradó hibákat.

A felhasználók [tünetet] tapasztalnak, amikor [kiváltó ok vagy bemenet] történik. A várt viselkedés [várt eredmény]. Kezdje azzal, hogy megvizsgálja a [mappát, függvényt vagy folyamatot] és a kapcsolódó teszteket. Hozzon létre egy sikertelen tesztet, amely reprodukálja a jelentett viselkedést. Ha nem tudja reprodukálni, magyarázza el, mit ellenőrizte és milyen információk hiányoznak, mielőtt módosítaná az implementációt. A reprodukálás után javítsa ki az okot anélkül, hogy megváltoztatná a [meg kell őrizni a viselkedést]. Futtassa az új tesztet és a [kapcsolódó tesztparancsot]. Mutassa be a javítás előtti hibát, az azt követő eredményeket és az esetleges fennmaradó hibákat.

11. Hibaüzenetet adó build diagnosztizálása az ellenőrzések megkerülése nélkül

Használd ezt, ha a build helyileg vagy a CI-ben sikertelen. Add meg a pontos parancsot és a vonatkozó hibaüzenetet, hogy Claude is kivizsgálhassa ugyanazt a hibát.

A [Build parancs] hibaüzenettel bukik meg a [helyi vagy CI környezetben], a következő kimenettel: [tisztított hibanapló]. Vizsgálja meg a vonatkozó kódot és konfigurációt az ok azonosítása érdekében. Ha a hiba helyileg nem reprodukálható, ellenőrizze a környezeti vagy függőségi eltéréseket. Végezze el a legkisebb változtatást, amely megoldja a problémát. Ne tiltsa le az ellenőrzéseket, ne szűrje ki a hibákat, ne hagyjon ki teszteket, és ne lazítsa meg a fordító beállításait pusztán azért, hogy a build sikeres legyen. A módosítás után futtassa újra a buildet. Ha [szám] javítási kísérlet után is sikertelen marad, álljon le, és jelentse be, mit próbált ki, mi a jelenlegi hiba, és mi a következő diagnosztikai lépés. Foglalja össze az okot, és csatolja a tényleges build eredményét.

A [Build parancs] hibaüzenettel bukik meg a [helyi vagy CI környezetben], a következő kimenettel: [tisztított hibanapló]. Vizsgálja meg a vonatkozó kódot és konfigurációt az ok azonosítása érdekében. Ha a hiba helyileg nem reprodukálható, ellenőrizze a környezeti vagy függőségi eltéréseket. Végezze el a legkisebb változtatást, amely megoldja a problémát. Ne tiltsa le az ellenőrzéseket, ne szűrje ki a hibákat, ne hagyjon ki teszteket, és ne lazítsa meg a fordító beállításait pusztán azért, hogy a build sikeres legyen. A módosítás után futtassa újra a buildet. Ha [szám] javítási kísérlet után is sikertelen marad, álljon le, és jelentse be, mit próbált ki, mi a jelenlegi hiba, és mi a következő diagnosztikai lépés. Foglalja össze az okot, és csatolja a tényleges build eredményét.

12. Szűkítse le a hiba körét kérdések segítségével

Használd ezt, ha a tünetek nem egyértelműek, vagy több magyarázat is valószínűnek tűnik. A célzott kérdések megválaszolása segíthet a hiba reprodukálásának előkészítésében, mielőtt bárki is módosítaná a kódot. Részletesebb útmutatást a Claude segítségével történő hibakeresésről itt találsz.

Segítsen leszűkíteni a hiba körét, mielőtt javítást javasolna. Megfigyelt viselkedés: [mi történik] Várt viselkedés: [mi kellene történnie] Mikor fordul elő: [feltételek vagy gyakoriság] Mit próbáltam már: [lépések és eredmények] Egyszerre csak egy kérdést tegyen fel, és válassza ki azt a kérdést, amely a legjobban megkülönbözteti a lehetséges okokat. Ne ismételje meg azokat a kérdéseket, amelyekre a megadott információk már választ adnak. Ha elegendő bizonyíték áll rendelkezésre, foglalja össze a legvalószínűbb magyarázatot, a még bizonytalan elemeket, valamint azt a legkisebb tesztet, amely megerősítheti vagy kizárhatja azt. Egyelőre ne szerkesszen fájlokat.

Segítsen leszűkíteni a hiba körét, mielőtt javítást javasolna. Megfigyelt viselkedés: [mi történik] Várt viselkedés: [mi kellene történnie] Mikor fordul elő: [feltételek vagy gyakoriság] Mit próbáltam már: [lépések és eredmények] Egyszerre csak egy kérdést tegyen fel, és válassza ki azt a kérdést, amely a legjobban megkülönbözteti a lehetséges okokat. Ne ismételje meg azokat a kérdéseket, amelyekre a megadott információk már választ adnak. Ha elegendő bizonyíték áll rendelkezésre, foglalja össze a legvalószínűbb magyarázatot, a még bizonytalan elemeket, valamint azt a legkisebb tesztet, amely megerősítheti vagy kizárhatja azt. Egyelőre ne szerkessze a fájlokat.

Utasítások az áttekintéshez és az ellenőrzéshez

A megvalósítást a követelményekhez viszonyítva vizsgálja át, ahelyett, hogy meghatározatlan hatókör mellett kérné Claude-ot a problémák felkutatására. Kérjen bizonyítékot minden megállapításhoz, és különböztesse meg a megerősített hibákat a további vizsgálatot igénylő kérdésektől.

13. Vizsgálja meg a változtatást a jóváhagyott tervhez viszonyítva

Használja ezt a megvalósítás után annak ellenőrzésére, hogy a diff megfelel-e a megállapodott követelményeknek. Adja meg az összehasonlítandó ágakat vagy az áttekintendő fájlokat, hogy a nem kapcsolódó munkák kimaradjanak az értékelésből.

Használjon alügynököt a [bázishoz viszonyított diff vagy ág] és a [jóváhagyott terv vagy követelményfájl] összehasonlításához. Ha a követelmények hiányoznak vagy nem egyértelműek, jelentsen erről még a teljesség értékelése előtt. Ellenőrizze, hogy minden követelmény megvalósult-e, a releváns szélsőséges esetek rendelkeznek-e tesztekkel, és hogy a változtatások nem esnek-e a megállapodott határon kívül. Szükség esetén vizsgálja meg a környező kódot a diff megértése érdekében. Jelentse a helyességi problémákat és a nem teljesített követelményeket fájl- és sorhivatkozásokkal, azok hatásával és az egyes megállapításokat alátámasztó bizonyítékokkal együtt. Válassza szét a megerősített problémákat a megoldatlan kérdésektől. Ne találjon ki megállapításokat a kvóta kitöltése érdekében, és ne vegyen fel nem kapcsolódó stílusbeli preferenciákat. Ne szerkessze a fájlokat.

Használjon alügynököt a [bázishoz viszonyított diff vagy ág] és a [jóváhagyott terv vagy követelményfájl] összehasonlításához. Ha hiányoznak vagy nem egyértelműek a követelmények, jelentsen erről még a teljesség értékelése előtt. Ellenőrizze, hogy minden követelmény megvalósult-e, a releváns szélsőséges esetekhez tartoznak-e tesztek, és hogy a változtatások nem esnek-e a megállapodott határon kívül. Szükség esetén vizsgálja meg a környező kódot a diff megértése érdekében. Jelentse a helyességi problémákat és a nem teljesített követelményeket fájl- és sorhivatkozásokkal, azok hatásával és az egyes megállapításokat alátámasztó bizonyítékokkal együtt. Válassza szét a megerősített problémákat a megoldatlan kérdésektől. Ne találjon ki megállapításokat a kvóta kitöltése érdekében, és ne vegyen fel nem kapcsolódó stílusbeli preferenciákat. Ne szerkessze a fájlokat.

14. Ellenőrizze, hogy egy változtatás nem jár-e bizonyos biztonsági kockázatokkal

Használja ezt a biztonsági szempontból érzékeny kódok – például a hitelesítés, a kérések kezelése vagy az adatbázis-hozzáférés – célzott áttekintéséhez. Kiegészítheti az általános kódáttekintést, de nem garantálja, hogy az alkalmazás biztonságos.

Ellenőrizze a [fájlokat vagy diff-eket] behatolási kockázatok, hiányzó jogosultsági ellenőrzések, nyilvánosságra került titkos adatok és a felhasználói bevitel nem biztonságos kezelése szempontjából. Mielőtt jelentést készítene egy észlelésről, vizsgálja meg a vonatkozó hívókat és az érvényesítési logikát. Minden egyes probléma esetében azonosítsa az érintett fájlt és sorokat, a probléma kiváltásához szükséges feltételeket, a várható hatást és a javasolt javítást. Különbséget kell tenni a megerősített sebezhető útvonal és a további tesztelést igénylő aggály között. Ne tüntesse fel a titkos értékeket a jelentésben, ne módosítsa a fájlokat, és ne végezzen tesztelést éles szolgáltatásokon. Adja meg, mely területeket vizsgálta át, és mi maradt a vizsgálat hatókörén kívül.

Ellenőrizze a [fájlokat vagy diff-eket] behatolási kockázatok, hiányzó jogosultsági ellenőrzések, nyilvánosságra került titkos adatok és a felhasználói bevitel nem biztonságos kezelése szempontjából. Mielőtt jelentést készítene egy észlelésről, vizsgálja meg a vonatkozó hívókat és az érvényesítési logikát. Minden egyes probléma esetében azonosítsa az érintett fájlt és sorokat, a probléma kiváltásához szükséges feltételeket, a várható hatást és a javasolt javítást. Különbséget kell tenni a megerősített sebezhető útvonal és a további tesztelést igénylő aggály között. Ne tüntesse fel a titkos értékeket a jelentésben, ne módosítsa a fájlokat, és ne végezzen tesztelést éles szolgáltatásokon. Adja meg, mely területeket vizsgálta át, és mi maradt a vizsgálat hatókörén kívül.

15. Kérj ellenőrzési összefoglalót, mielőtt elfogadnál egy módosítást

Használd ezt egy kódmódosító feladat után, hogy megnézd, mit ellenőriztek valójában. Segít megkülönböztetni a sikeres tesztfutást a nem támogatott „kész” üzenettől.

Összegezze, hogyan ellenőrizte a végrehajtott változtatást az [elfogadási kritériumok] alapján. Minden kritériumhoz sorolja fel az elvégzett ellenőrzést, adott esetben a pontos parancsot és a megfigyelt eredményt. Mellékelje a releváns kimenetet, a titkos és érzékeny adatok elrejtésével. A már korábban fennálló hibákat külön jelölje meg. Világosan különböztesse meg a sikeres, a sikertelen és a le nem futtatott ellenőrzéseket. Magyarázza el az esetleges kihagyott ellenőrzéseket vagy a lefedettség korlátait. Ne írja le a teljes változtatást ellenőrzöttként, ha egyes kritériumok ellenőrzése elmaradt.

Összegezze, hogyan ellenőrizte a végrehajtott változtatást az [elfogadási kritériumok] alapján. Minden kritériumhoz sorolja fel az elvégzett ellenőrzést, adott esetben a pontos parancsot és a megfigyelt eredményt. Mellékelje a releváns kimenetet, a titkos és érzékeny adatok elrejtésével. A már korábban fennálló hibákat külön jelölje meg. Világosan különböztesse meg a sikeres, a sikertelen és a le nem futtatott ellenőrzéseket. Magyarázza el az esetleges kihagyott ellenőrzéseket vagy a lefedettség korlátait. Ne írja le a teljes változtatást ellenőrzöttként, ha egyes kritériumok ellenőrzése elmaradt.

Utasítások a refaktoráláshoz és a migrációkhoz

A refaktorálásnak meg kell őriznie a meglévő viselkedést, míg a migrációknak figyelembe kell venniük a régi és az új megvalósítás közötti különbségeket. Kezdjen korlátozott hatókörrel, és határozza meg, mely ellenőrzések tárják fel a nem szándékos változásokat.

16. Refaktorálás a viselkedés megváltoztatása nélkül

Használja ezt akkor, amikor a megvalósítás átalakításra szorul, de a bemenetei, kimenetei és nyilvános interfésze változatlanok maradnak.

Átírja a [fájlt vagy modult] egy [konkrét cél, például egy nagy függvény felosztása vagy a beágyazott visszahívások eltávolítása] érdekében. Megőrzi annak nyilvános felületét, visszatérési értékeit, hiba kezelését és mellékhatásait. A szerkesztés előtt futtassa le a [vonatkozó tesztparancsot] az alapállapot rögzítése érdekében. Ha a teszt sikertelen, jelentse a hibákat, mielőtt továbbhaladna. Azonosítsa azokat a viselkedéseket, amelyeket a meglévő tesztek nem fednek le, és szükség szerint adjon hozzá célzott teszteket. Végezze el az átírást úgy, hogy ne legyenek benne nem kapcsolódó változtatások vagy új függőségek. Ne gyengítse a meglévő állításokat az implementációhoz való igazodás érdekében. Futtassa újra a teszteket és a [típusellenőrző vagy lint parancsot]. Mutassa be az átalakítás előtti és utáni eredményeket, foglalja össze a szerkezeti változásokat, és jelölje meg azokat a viselkedéseket, amelyeket nem tudott ellenőrizni.

Átírja a [fájlt vagy modult] egy [konkrét cél, például egy nagy függvény felosztása vagy a beágyazott visszahívások eltávolítása] érdekében. Megőrzi annak nyilvános felületét, visszatérési értékeit, hiba kezelését és mellékhatásait. A szerkesztés előtt futtassa le a [vonatkozó tesztparancsot] az alapállapot rögzítése érdekében. Ha a teszt sikertelen, jelentse a hibákat, mielőtt továbbhaladna. Azonosítsa azokat a viselkedéseket, amelyeket a meglévő tesztek nem fednek le, és szükség szerint adjon hozzá célzott teszteket. Végezze el az átírást úgy, hogy ne legyenek benne nem kapcsolódó változtatások vagy új függőségek. Ne gyengítse a meglévő állításokat az implementációhoz való igazodás érdekében. Futtassa újra a teszteket és a [típusellenőrző vagy lint parancsot]. Mutassa be az átalakítás előtti és utáni eredményeket, foglalja össze a szerkezeti változásokat, és jelölje meg azokat a viselkedéseket, amelyeket nem tudott ellenőrizni.

17. Tesztelje az áttelepítést egy kis fájlkészleten

Használd ezt, mielőtt egy API-t vagy könyvtárat cserélnél egy teljes repositoryban. Egy kis kísérleti projekt segít feltárni a kompatibilitási problémákat, mielőtt ugyanaz a változás minden hívóhoz eljutna.

Keresse meg az [régi API vagy könyvtár] használatait a [könyvtár hatókörén] belül, a generált és a beszállítói fájlok kizárásával. Sorolja fel az érintett fájlokat, valamint az összes olyan megosztott konfigurációt vagy függőséget, amelyet az áttérés érinthet. Javasoljon három reprezentatív fájlt egy kísérleti áttéréshez az [új API-ra vagy verzióra], az [áttérési útmutató vagy meglévő példa] felhasználásával. Magyarázza el, miért választotta ki őket, és jelölje meg az esetleges szükséges viselkedésbeli változásokat. A szerkesztés előtt várja meg a jóváhagyásomat. A jóváhagyás után csak a kísérleti fájlokat és a kifejezetten jóváhagyott megosztott függőségeket migrálja. Futtassa a [vonatkozó teszteket] és a [build vagy típusellenőrző parancsot]. Ne terjessze ki a migrációt más fájlokra. Jelentse a különbségeket, a teszt eredményeket, a kompatibilitási problémákat és a migrációs megközelítésben szükséges változtatásokat. A többi fájl feldolgozása előtt álljon meg felülvizsgálatra.

Keresse meg az [régi API vagy könyvtár] használatait a [könyvtár hatókörén] belül, a generált és a beszállítói fájlok kizárásával. Sorolja fel az érintett fájlokat, valamint az összes olyan megosztott konfigurációt vagy függőséget, amelyet az áttérés érinthet. Javasoljon három reprezentatív fájlt egy kísérleti áttéréshez az [új API-ra vagy verzióra], az [áttérési útmutató vagy meglévő példa] felhasználásával. Magyarázza el, miért választotta ki őket, és jelölje meg az esetleges szükséges viselkedésbeli változásokat. A szerkesztés előtt várja meg a jóváhagyásomat. A jóváhagyás után csak a kísérleti fájlokat és a kifejezetten jóváhagyott megosztott függőségeket migrálja. Futtassa a [vonatkozó teszteket] és a [build vagy típusellenőrző parancsot]. Ne terjessze ki a migrációt más fájlokra. Jelentse a különbségeket, a teszt eredményeket, a kompatibilitási problémákat és a migrációs megközelítéshez szükséges változtatásokat. A többi fájl feldolgozása előtt álljon meg felülvizsgálatra.

A kísérleti projekt áttekintése után a többit kontrollált csoportokban migrálja. A Claude Code /batch parancsa a jóváhagyott munkákat elszigetelt Git munkafák között oszthatja szét; a claude -p parancsot ismétlő szkript nem biztosítja automatikusan ezt az elszigeteltséget. A párhuzamosítás előtt ellenőrizze a megosztott fájlok változásait, majd vizsgálja át és tesztelje az összesített eredményt. A függetlenül futtatható feladatok kiválasztásáról bővebben a többügynökös munkafolyamatoknál olvashat.

Utasítások a Githez, a pull requestekhez és a dokumentációhoz

Használd ezeket az útmutatásokat a változtatások felülvizsgálatra való előkészítéséhez, valamint a kód használatának elmagyarázásához. A commitokat korlátozd a tervezett munkára, és a dokumentációt olyan parancsokra és viselkedésre alapozd, amelyeket a repositoryban ellenőrizni tudsz.

18. Készítsen elő egy commitot és egy pull requestet

Használd ezt, amikor a megvalósítás készen áll az áttekintésre. A Claude-nak meg kell különböztetnie a tervezett változtatásokat az ugyanabban a munkakönyvtárban található, azokhoz nem kapcsolódó munkáktól.

Vizsgáld meg az aktuális ágat, a Git állapotát és a [funkció vagy javítás] diffjét. Azonosítsd a változáshoz tartozó fájlokat, és külön sorold fel a nem kapcsolódó vagy nyomon nem követett fájlokat. Írj egy commit üzenetet az utolsó 10 commit formátumát követve. Készíts egy pull request leírást, amely tartalmazza, mi változott, miért, milyen teszteket futtattál le, és milyen korlátozások maradtak fenn. Mielőtt bármit is staging-be helyeznél vagy közzétennél, mutasd meg a javasolt fájllistát, a commit üzenetet és a PR leírást. Várd meg a jóváhagyásomat. A jóváhagyás után csak a megegyezés szerinti fájlokat helyezd staging-be, hajts végre commit-ot a [feature branch]-en, push-old a [remote]-ra, és nyiss pull request-et a [base branch]-re. Ne módosíts meglévő commit-okat, ne hajts végre force-push-t és ne végez összevonást. Küldd vissza a commit hash-t és a PR linket.

Vizsgáld meg az aktuális ágat, a Git állapotát és a [funkció vagy javítás] diffjét. Azonosítsd a változáshoz tartozó fájlokat, és külön sorold fel a nem kapcsolódó vagy nyomon nem követett fájlokat. Írj egy commit üzenetet az utolsó 10 commit formátumát követve. Készíts egy pull request leírást, amely tartalmazza, mi változott, miért, milyen teszteket futtattál le, és milyen korlátozások maradtak fenn. Mielőtt bármit is staging-be helyeznél vagy közzétennél, mutasd meg a javasolt fájllistát, a commit üzenetet és a PR leírást. Várd meg a jóváhagyásomat. A jóváhagyás után csak a megegyezés szerinti fájlokat helyezd staging-be, hajts végre commit-ot a [feature branch]-en, push-old a [remote]-ra, és nyiss meg egy pull request-et a [base branch]-hez. Ne módosíts meglévő commit-okat, ne hajts végre force-push-t és ne hajts végre merge-t. Küldd vissza a commit hash-t és a PR linket.

19. Írj dokumentációt egy konkrét olvasó számára

Használd ezt, ha egy modulhoz beállítási vagy használati utasításokra van szükség. Az olvasó megnevezése segít Claude-nak a megfelelő részletességi szint kiválasztásában; a projekt szkriptekre való hivatkozás pedig segít elkerülni a kitalált parancsokat.

Írjon egy README-szakaszt a [modul]hoz, amelynek célközönsége [olvasó, például a projekthez csatlakozó háttérfejlesztő]. Foglalja össze az előfeltételeket, a beállítást, a három leggyakrabban használt parancsot, valamint a kód vagy a meglévő dokumentáció által támogatott gyakori hibákat. Ellenőrizze a parancsneveket és az opciókat a [csomag szkriptek, a Makefile, a CLI súgó vagy a CI konfiguráció] alapján. Jelölje meg mindazt, amit nem tud megerősíteni. Tesztelje a biztonságos helyi parancsokat a [tesztkörnyezetben], amennyiben rendelkezésre áll. Mielőtt olyan parancsokat futtatna, amelyek függőségeket telepítenek, fájlokat törölnek, adatokat migrálnak, telepítenek vagy külső szolgáltatásokhoz férnek hozzá, magyarázza el azok hatásait, és kérjen jóváhagyást. Világosan különböztesse meg a sikeresen futtatott parancsokat azoktól, amelyeket csak a konfiguráció vagy a dokumentáció alapján ellenőrzött. Mutassa meg a javasolt README-szakaszt a [dokumentáció elérési útja] szerkesztése előtt, és őrizze meg a nem kapcsolódó tartalmakat.

Írjon egy README-szakaszt a [modul]hoz, amelynek célközönsége [olvasó, például a projekthez csatlakozó háttérfejlesztő]. Foglalja össze az előfeltételeket, a beállítást, a három leggyakrabban használt parancsot, valamint a kód vagy a meglévő dokumentáció által támogatott gyakori hibákat. Ellenőrizze a parancsneveket és az opciókat a [csomag szkriptek, a Makefile, a CLI súgó vagy a CI konfiguráció] alapján. Jelölje meg mindazt, amit nem tud megerősíteni. Tesztelje a biztonságos helyi parancsokat a [tesztkörnyezetben], amennyiben rendelkezésre áll. Mielőtt olyan parancsokat futtatna, amelyek függőségeket telepítenek, fájlokat törölnek, adatokat migrálnak, telepítenek vagy külső szolgáltatásokhoz férnek hozzá, magyarázza el azok hatásait, és kérjen jóváhagyást. Világosan különböztesse meg a sikeresen futtatott parancsokat azoktól, amelyeket csak a konfiguráció vagy a dokumentáció alapján ellenőrzött. Mutassa meg a javasolt README-szakaszt a [dokumentáció elérési útja] szerkesztése előtt, és őrizze meg a nem kapcsolódó tartalmakat.

Utasítások a Claude Code konfigurálásához

Használd ezeket az útmutatásokat a repository utasításainak karbantartásához, az ismétlődő ellenőrzések automatizálásához és egy ismeretlen parancssori eszköz értékeléséhez. Ellenőrizd a konfigurációs változtatásokat, mielőtt alkalmaznád őket, különösen akkor, ha azok befolyásolják, mely parancsok futnak automatikusan.

20. A CLAUDE.md áttekintése és egyszerűsítése

Használd ezt akkor, ha az utasításfájlban felesleges szabályok, elavult parancsok vagy a kódból már egyértelműen kitűnő tanácsok halmozódtak fel. Tartsd meg azokat a projektspecifikus információkat, amelyekre a Claude-nak szüksége van a megfelelő működéshez.

Vizsgálja át a [CLAUDE.md elérési útja] fájlt a repository jelenlegi felépítése, szkriptjei és konvenciói alapján. Egyelőre ne szerkessze a fájlt! Azonosítsa az elavult utasításokat, az ismétlődéseket, az ellentmondásokat, valamint azokat a szabályokat, amelyek megbízhatóan levezethetők a kódból. Indokolja meg az egyes törlési javaslatokat, ne csak azért távolítson el utasításokat, hogy lerövidítse a fájlt. Hiányzó build- vagy tesztparancsokat csak akkor javasoljon, ha azokat a projekt szkriptjeiben, egy Makefile-ban, a CI-konfigurációban vagy a meglévő dokumentációban ellenőrizni tudja. Minden hozzáadásnál hivatkozz a forrásra. Küldj be egy olyan diff-javaslatot, amely megőrzi a fontos projektkorlátozásokat. Jelöld meg azokat a feladatspecifikus utasításokat, amelyek jobban illeszkednének egy skillbe vagy path-hatókörű szabályba, és várd meg a jóváhagyást, mielőtt alkalmaznád a változtatásokat.

Vizsgálja át a [CLAUDE.md elérési útja] fájlt a repository jelenlegi felépítéséhez, szkriptjeihez és konvencióihoz képest. Egyelőre ne szerkessze a fájlt! Azonosítsa az elavult utasításokat, az ismétlődéseket, az ellentmondásokat, valamint azokat a szabályokat, amelyek megbízhatóan levezethetők a kódból. Indokolja meg az egyes törlési javaslatokat, ne csak azért töröljön utasításokat, hogy rövidítse a fájlt. Hiányzó build- vagy tesztparancsokat csak akkor javasoljon, ha azokat a projekt szkriptjeiben, egy Makefile-ban, a CI-konfigurációban vagy a meglévő dokumentációban ellenőrizni tudja. Minden hozzáadásnál hivatkozz a forrásra. Küldj be egy olyan diff-javaslatot, amely megőrzi a fontos projektkorlátozásokat. Jelöld meg azokat a feladatspecifikus utasításokat, amelyek jobban illeszkednének egy skillbe vagy path-hatókörű szabályba, és várd meg a jóváhagyást, mielőtt alkalmaznád a változtatásokat.

21. Formázási hook konfigurálása

Használd ezt akkor, ha egy formázónak automatikusan el kell futnia a támogatott fájlszerkesztések után. Korlátozd a hookot a releváns fájlokra, és teszteld a viselkedését, mielőtt rá támaszkodnál.

Javasoljon egy Claude Code parancs-hookot, amely az [fájlminta] szerkesztése vagy írása utáni változások esetén futtatja a [meglévő formázóparancsot]. Először vizsgálja meg a claude/settings.json fájlban található meglévő konfigurációt és a formázó beállításait. Használja a telepített Claude Code verzióhoz megfelelő PostToolUse konfigurációt. Csak az érintett fájlt formázza, kezelje biztonságosan az elérési utakat, és zárja ki a [generált fájlokat vagy más kizárt elérési utakat]. Ne telepítsen függőségeket, és ne cserélje ki a meglévő hookokat. Mutassa be a javasolt beállítások közötti különbségeket, és magyarázza el, hogyan kerülnek jelentésre a formázó hibái. Várja meg a jóváhagyást, mielőtt alkalmazná. A jóváhagyás után tesztelje egy ideiglenes fájllal a projektben, és jelentse az eredményt. Adja meg, mely szerkesztési útvonalakat fedi le, és melyeket nem, beleértve a shell-parancsokkal végzett módosításokat is.

Javasoljon egy Claude Code parancs-hookot, amely az [fájlminta] szerkesztése vagy írása után futtatja a [meglévő formázó parancsot]. Először vizsgálja meg a claude/settings.json fájlban található meglévő konfigurációt és a formázó beállításait. Használja a telepített Claude Code verzióhoz megfelelő PostToolUse konfigurációt. Csak az érintett fájlt formázza, kezelje biztonságosan az elérési utakat, és zárja ki a [generált fájlokat vagy más kizárt elérési utakat]. Ne telepítsen függőségeket, és ne cserélje ki a meglévő hookokat. Mutassa be a javasolt beállítások közötti különbségeket, és magyarázza el, hogyan kerülnek jelentésre a formázó hibái. Várja meg a jóváhagyást, mielőtt alkalmazná. A jóváhagyás után tesztelje egy ideiglenes fájllal a projektben, és jelentse az eredményt. Adja meg, mely szerkesztési útvonalakat fedi le, és melyeket nem, beleértve a shell-parancsokkal végzett módosításokat is.

22. Ismeretlen CLI használata előtt értékelje azt

Használd ezt akkor, ha egy feladat olyan parancssori eszközt igényel, amellyel még nem dolgoztál korábban. A súgó kimenetének áttekintésével megismerheted a támogatott opciókat, de még így is meg kell értened a javasolt parancsok hatásait.

Nézze át a [szerszám] –help parancsot és a [feladat] szempontjából releváns alparancsok súgóját. Ne telepítse a szerszámot, ha hiányzik; ehelyett jelentsen be az előfeltételt. Javasolja a feladat elvégzéséhez szükséges pontos parancsokat. Magyarázza el azok bemeneteit, kimeneteit, valamint azt, hogy írnak-e fájlokat, módosítanak-e távoli erőforrásokat, vagy használnak-e hitelesítő adatokat. Ha az eszköz dokumentációja tartalmaz ilyen opciót, vegye fel a próbafutás opciót is. Jelölje meg a hiányzó konfigurációkat vagy jogosultságokat, és kérjen pontosítást, ahelyett, hogy találgatna az erőforrásnevekről vagy a célhelyekről. Várja meg a jóváhagyást, mielőtt futtatná a feladatparancsokat. A jóváhagyás után csak a megegyezés szerinti parancsokat futtassa, és jelentse azok tényleges eredményeit, beleértve az esetleges hibákat vagy a befejezetlen lépéseket is.

Nézze át a [szerszám] –help parancsot és a [feladat] szempontjából releváns alparancsok súgóját. Ne telepítse a szerszámot, ha hiányzik; ehelyett jelentsen be az előfeltételt. Javasolja a feladat elvégzéséhez szükséges pontos parancsokat. Magyarázza el azok bemeneteit, kimeneteit, valamint azt, hogy írnak-e fájlokat, módosítanak-e távoli erőforrásokat, vagy használnak-e hitelesítő adatokat. Ha az eszköz dokumentációja tartalmaz ilyen opciót, vegye fel a próbafutás opciót is. Jelölje meg a hiányzó konfigurációkat vagy jogosultságokat, és kérjen pontosítást, ahelyett, hogy találgatna az erőforrásnevekről vagy a célhelyekről. Várja meg a jóváhagyást, mielőtt futtatná a feladatparancsokat. A jóváhagyás után csak a megegyezés szerinti parancsokat futtassa, és jelentse azok tényleges eredményeit, beleértve az esetleges hibákat vagy a befejezetlen lépéseket is.

Feladatok azoknak, akik nem kódírásból élnek

A Claude Code segítséget nyújt a fájlalapú elemzések, az ismétlődő jelentések és a forrásanyagokon alapuló dokumentumok elkészítésében. Adja meg a kimenet értékeléséhez szükséges üzleti szabályokat és példákat, és a termelési adatok helyett inkább a jóváhagyott adatok másolatait használja.

23. Számlák és kifizetések egyeztetése

Használja ezt akkor, ha a kifizetések és a számlák között nincs egyszerű egy-egy kapcsolat. Határozza meg, hogyan kell kezelni a részleges kifizetéseket, az ismétlődő rekordokat és az egyezés nélküli kifizetéseket, mielőtt összehasonlítaná az összegeket.

Hasonlítsa össze a [invoices.csv] és a [payments.csv] fájlokat a [számlaazonosító vagy egyező kulcs] segítségével. Ne módosítsa a forrásfájlokat. Alkalmazza a következő szabályokat: [pénznem és kerekítési tűrés], [részleges befizetések elosztása] és [visszatérítések, jóváírások és túlfizetések kezelése]. Ha hiányzik egy szabály, vagy az egyezés nem egyértelmű, jelölje meg, ahelyett, hogy automatikusan hozzárendelné a befizetést. Tartsa meg a forrás sorok azonosítóit. Minden számla esetében mutassa meg a számlázott összeget, a jóváírt befizetéseket és a fennmaradó egyenleget. Jelentsd az ismétlődő azonosítókat, az egyezés nélküli számlákat, az egyezés nélküli befizetéseket és a tűréshatáron kívüli egyenlegeket. A számla- és befizetési összegeket külön egyeztesd. Minden forrássorral számolj el anélkül, hogy kétszer számolnád; ha egy befizetés több számlára oszlik, mutasd be az egyes allokációkat, és ellenőrizd, hogy azok összege nem haladja-e meg a befizetés összegét. Írd az eredményeket az [új kimeneti útvonalakra], és foglald össze a felülvizsgálatot igénylő kivételeket.

Hasonlítsa össze a [invoices.csv] és a [payments.csv] fájlokat a [számlaazonosító vagy egyező kulcs] segítségével. Ne módosítsa a forrásfájlokat. Alkalmazza a következő szabályokat: [pénznem és kerekítési tűrés], [részleges befizetések elosztása] és [visszatérítések, jóváírások és túlfizetések kezelése]. Ha hiányzik egy szabály, vagy az egyezés nem egyértelmű, jelölje meg, ahelyett, hogy automatikusan hozzárendelné a befizetést. Tartsa meg a forrás sorok azonosítóit. Minden számla esetében mutassa meg a számlázott összeget, a jóváírt befizetéseket és a fennmaradó egyenleget. Jelentsd az ismétlődő azonosítókat, az egyezés nélküli számlákat, az egyezés nélküli befizetéseket és a tűréshatáron kívüli egyenlegeket. A számla- és befizetési összegeket külön egyeztesd. Minden forrássorral számolj el anélkül, hogy kétszer számolnád; ha egy befizetés több számlára oszlik, mutasd be az egyes allokációkat, és ellenőrizd, hogy azok összege nem haladja-e meg a befizetés összegét. Írd az eredményeket [új kimeneti útvonalakra], és foglald össze a felülvizsgálatot igénylő kivételeket.

24. Heti üzemeltetési jelentés készítése

Használja ezt az exportált adatokból létrehozott ismétlődő jelentésekhez. Adja meg a jelentési időszakot és a kategóriadefiníciókat, hogy a szkript minden héten ugyanazokat a szabályokat alkalmazza.

Írjon egy szkriptet, amely összefoglalja az [export.csv] fájlt a [kezdő dátum és idő (beleértve)] és a [záró dátum és idő (kizárva)] közötti időszakra, a [időzóna] és a [dátum oszlop] felhasználásával. Csoportosítsa a rekordokat a [kategória szabályok] szerint, és számítsa ki a [szükséges mutatókat]. Kezelje az ismétlődő azonosítókat és a hiányzó értékeket a [szabályok] szerint. Ne módosítsa a bemeneti fájlt! Futtassa a szkriptet a [pontos bemeneti fájlon]! Jelentse a felvett és kizárt sorok számát, a kategóriák összegét, valamint azokat a rekordokat, amelyeket nem lehetett besorolni! Hasonlítsa össze a [három kategória] eredményeit a [referenciafájlban] található, függetlenül ellenőrzött számadatokkal! Ha ezek a számadatok nem állnak rendelkezésre, jelezze, hogy a független érvényesítés még nem történt meg! Mutassa be az eltéréseket, és mentse a jelentést az [új kimeneti útvonalra]!

Írjon egy szkriptet, amely összefoglalja az [export.csv] fájlt a [kezdő dátum és idő (beleértve)] és a [záró dátum és idő (kizárva)] közötti időszakra, a [időzóna] és a [dátum oszlop] felhasználásával. Csoportosítsa a rekordokat a [kategória szabályok] szerint, és számítsa ki a [szükséges mutatókat]. Kezelje az ismétlődő azonosítókat és a hiányzó értékeket a [szabályok] szerint. Ne módosítsa a bemeneti fájlt! Futtassa a szkriptet a [pontos bemeneti fájlon]! Jelentse a felvett és kizárt sorok számát, a kategóriák összegét, valamint azokat a rekordokat, amelyeket nem lehetett besorolni! Hasonlítsa össze a [három kategória] eredményeit a [referenciafájlban] található, függetlenül ellenőrzött számadatokkal! Ha ezek a számadatok nem állnak rendelkezésre, jelezze, hogy a független érvényesítés még nem történt meg! Mutassa be az eltéréseket, és mentse a jelentést az [új kimeneti útvonalra]!

25. Készítsen dokumentumot a forrásfájlokból

Használja ezt, ha jóváhagyott dokumentumokon vagy kódon alapuló magyarázatra van szüksége. Kérjen olyan konkrét hivatkozásokat, amelyek alapján a felülvizsgáló ellenőrizni tudja az egyes állításokat.

Olvassa el a [megadott fájlokat vagy mappát], és készítsen [dokumentumtípus és hossz] tervezetet a [célközönség] számára, amely kitér a [kérdésekre vagy témákra]. Minden ténybeli állítást támasztaljon alá fájlnévvel, valamint oldal-, szakasz- vagy sorhivatkozással, amennyiben rendelkezésre áll. Különböztesse meg a közvetlen idézeteket a parafrázisoktól, és ne kezelje a javaslatokat vagy elavult dokumentumokat megerősített, aktuális döntésként. Jelölje meg az egymásnak ellentmondó forrásokat, a hiányzó információkat és azokat az állításokat, amelyeket nem tud ellenőrizni. Ne pótolja a hiányzó információkat feltételezésekkel, és ne szerkessze a forrásfájlokat. Adja vissza a vázlatot a hivatkozásokkal és a lektor számára egy rövid listával a megoldatlan kérdésekről.

Olvassa el a [megadott fájlokat vagy mappát], és készítsen [dokumentumtípus és hossz] tervezetet a [célközönség] számára, amely kitér a [kérdésekre vagy témákra]. Minden ténybeli állítást támasztaljon alá fájlnévvel, valamint – amennyiben lehetséges – oldal-, szakasz- vagy sorhivatkozással. Különítse el a közvetlen idézeteket a parafrázisoktól, és ne kezelje a javaslatokat vagy elavult dokumentumokat megerősített, aktuális döntésként. Jelölje meg az egymásnak ellentmondó forrásokat, a hiányzó információkat és azokat az állításokat, amelyeket nem tud ellenőrizni. Ne pótolja a hiányzó információkat feltételezésekkel, és ne szerkessze a forrásfájlokat. Adja vissza a vázlatot a hivatkozásokkal és a lektor számára egy rövid listával a megoldatlan kérdésekről.

További információk: A Claude AI használata

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, megtisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat az @src/widgets/Weather.tsx” konkrét iránymutatást ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció rögzítésére ugyanazon a nézőtéren.

Kérd meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizd, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem bizonyítja, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomja meg az Esc billentyűt a futó válasz megszakításához. Ha a parancssor üres, nyomja meg kétszer az Esc billentyűt a visszatekerés menü megnyitásához, majd válassza ki, mit szeretne visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használjon Git ellenőrzőpontokat és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési út hatókörű szabályokba. Használjon hookokat az egyes eseményekhez kötött műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásban vagy specifikációban szerepel, nem pedig a CLAUDE.md fájlban. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensspecifikus konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, ellenőrizd ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér fel a döntésre, így ez sem determinisztikus.” Egy olyan szabály esetében, amelyet be kell tartani, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `.claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés nem hagyott-e megoldatlanul fontos döntéseket. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, adjon mindegyiknek egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendelje hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérjen bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsa szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot venné az egész módosítás igazolásának.

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok alátámasztják ezt a következtetést.

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, tisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat a @src/widgets/Weather.tsx” konkrét támpontot ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció rögzítésére ugyanazon a nézőtéren.

Kérd meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizd, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem bizonyítja, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomja meg az Esc billentyűt a futó válasz megszakításához. Ha a parancssor üres, nyomja meg kétszer az Esc billentyűt a visszatekerés menü megnyitásához, majd válassza ki, mit szeretne visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használjon Git ellenőrzőpontokat és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési út hatókörű szabályokba. Használjon hookokat az egyes eseményekhez kötött műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásban vagy specifikációban szerepel, nem pedig a CLAUDE.md fájlban. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensekre vonatkozó konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, ellenőrizd ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér meg a döntés meghozatalára, így ez sem determinisztikus.” Egy olyan szabály esetében, amelyet be kell tartani, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `.claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés nem hagyott-e megoldatlanul fontos döntéseket. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, mindegyiknek adjon egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendeld hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérj bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsd szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot vennél alapul a teljes módosítás ellenőrzéséhez.

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok alátámasztják ezt a következtetést.

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, tisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat a @src/widgets/Weather.tsx” konkrét támpontot ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció rögzítésére ugyanazon a nézőtéren.

Kérd meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizd, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem bizonyítja, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomd meg az Esc gombot a futó válasz megszakításához. Ha a parancssor üres, nyomd meg kétszer az Esc gombot a visszatekerés menü megnyitásához, és válaszd ki, mit szeretnél visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használd a Git ellenőrzőpontjait és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési útvonalra vonatkozó szabályokba. Használjon hookokat az egyes eseményekhez kapcsolódó műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásban vagy specifikációban szerepel, nem pedig a CLAUDE.md fájlban. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensspecifikus konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, ellenőrizd ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér fel a döntésre, így ez sem determinisztikus.” Egy olyan szabály esetében, amelyet be kell tartani, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés nem hagyott-e megoldatlanul fontos döntéseket. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, adjon mindegyiknek egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendeld hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérj bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsd szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot vennél alapul a teljes módosítás ellenőrzéséhez.

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok alátámasztják ezt a következtetést.

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, tisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat a @src/widgets/Weather.tsx” konkrét támpontot ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció ugyanazon a nézőtéren történő rögzítéséhez.

Kérd meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizd, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem jelenti azt, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomja meg az Esc billentyűt a futó válasz megszakításához. Ha a parancssor üres, nyomja meg kétszer az Esc billentyűt a visszatekerés menü megnyitásához, majd válassza ki, mit szeretne visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használjon Git ellenőrzőpontokat és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési út hatókörű szabályokba. Használjon hookokat az egyes eseményekhez kötött műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásban vagy specifikációban szerepel, nem pedig a CLAUDE.md fájlban. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensspecifikus konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, ellenőrizd ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér fel a döntésre, így ez sem determinisztikus.” Egy olyan szabály esetében, amelyet be kell tartani, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `.claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés nem hagyott-e megoldatlanul fontos döntéseket. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, mindegyiknek adjon egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendeld hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérj bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsd szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot vennél a teljes módosítás igazolásának.

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok alátámasztják ezt a következtetést.

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, tisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat az @src/widgets/Weather.tsx” konkrét iránymutatást ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció ugyanazon a nézőtéren történő rögzítéséhez.

Kérje meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizze, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem bizonyítja, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomd meg az Esc gombot a futó válasz megszakításához. Ha a parancssor üres, nyomd meg kétszer az Esc gombot a visszatekerés menü megnyitásához, és válaszd ki, mit szeretnél visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használj Git ellenőrzőpontokat és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési út hatókörű szabályokba. Használjon hookokat az egyes eseményekhez kötött műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásba vagy specifikációba tartozik, nem pedig a CLAUDE.md fájlba. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensekre vonatkozó konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, nézd át ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér meg a döntés meghozatalára, így ez sem determinisztikus.” Egy olyan szabály esetében, amelyet be kell tartani, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `.claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés során maradtak-e megoldatlan fontos döntések. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, mindegyiknek adjon egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendelje hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérjen bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsa szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot venné a teljes módosítás igazolásának.

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok alátámasztják ezt a következtetést.

Hogyan írjunk Claude Code-utasítást öt lépésben

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, megtisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat a @src/widgets/Weather.tsx” konkrét támpontot ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció rögzítésére ugyanazon a nézőtéren.

Kérd meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizd, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem bizonyítja, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomja meg az Esc billentyűt a futó válasz megszakításához. Ha a parancssor üres, nyomja meg kétszer az Esc billentyűt a visszatekerés menü megnyitásához, majd válassza ki, mit szeretne visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használjon Git ellenőrzőpontokat és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési út hatókörű szabályokba. Használjon hookokat az egyes eseményekhez kötött műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásban vagy specifikációban szerepel, nem pedig a CLAUDE.md fájlban. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensspecifikus konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, ellenőrizd ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér meg a döntés meghozatalára, így ez sem determinisztikus.” Egy olyan szabály esetében, amelyet be kell tartani, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `.claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés során maradtak-e megoldatlan fontos döntések. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, adjon mindegyiknek egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendeld hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérj bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsd szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot vennél a teljes módosítás igazolásának.

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok alátámasztják ezt a következtetést.

A sablon testreszabásához cserélje ki a helyőrzőket a projekt adataival, és döntse el, mit kell tennie a Claude-nak, mielőtt módosításokat hajtana végre. Kövesse ezeket a lépéseket a kérés előkészítéséhez és az eredmény ellenőrzéséhez.

1. lépés: Döntsd el, hogy a feladathoz szükség van-e tervre

Egy kis, jól meghatározott változtatás esetén megkérheted Claude-ot, hogy közvetlenül hajtsa végre azt. Ismeretlen kód, több fájlt érintő változtatások vagy tisztázatlan követelmények esetén kezdj egy tervvel!

Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítsa el a Claude Code-ot a claude --permission-mode plan paranccsal. Ebben a módban a Claude átvizsgálhatja a fájlokat és olvasási joggal rendelkező parancsokat futtathat anélkül, hogy szerkesztené a forráskódot. Tekintse át a javasolt fájlokat, függőségeket és teszteket, mielőtt jóváhagyná a megvalósítást. Nyomja meg a Ctrl+G billentyűkombinációt a javasolt terv megnyitásához a szerkesztőjében.

2. lépés: A releváns forrásanyagok biztosítása

Adja meg Claude-nak a feladat megértéséhez szükséges információkat: fájlhivatkozást, megtisztított hibajelentést, képernyőképet vagy követelménydokumentumot. A @ jel után írja be a fájl elérési útját, hogy beilleszthesse a fájl tartalmát.

Válassza ki a források legkisebb hasznos halmazát. Egy teljes napló vagy könyvtár bevonása irreleváns anyagot eredményezhet, és elvonhatja a figyelmet a kontextusról. A naplók megosztása előtt távolítsa el a hitelesítő adatokat és az érzékeny információkat, és ellenőrizze, hogy a Claude rendelkezik-e a szükséges eszközökkel az Ön által megadott dokumentációs URL-ek lekéréséhez.

Például a cat error.log | claude -p "Explain this error" parancs egy nem interaktív kéréssel küldi el a naplófájlt. Csak a fájl tartalmának ellenőrzése után használja! Ez a kontextusfüggő mesterséges intelligencia gyakorlati értéke: releváns információkat ad a modellnek a feladat elvégzéséhez.

3. lépés: Mutasson egy meglévő megvalósításra

Funkció hozzáadásakor keressen meg egy hasonló komponenst vagy függvényt a kódtárban. Adja meg Claude-nak, hogy mely konvenciókat kövesse, például az API-kliens, az érvényesítési logika, a hiba kezelése vagy a tesztelési struktúra tekintetében.

A „Kövesse nyomon, hogyan tölti be és tárolja az adatokat a @src/widgets/Weather.tsx” konkrét támpontot ad a Claude-nak. Nevezze meg továbbá az új funkció által megkövetelt eltéréseket is, hogy ne másolja át a már nem megfelelő viselkedést. Ezeknek a konvencióknak tükrözniük kell a csapata szoftverfejlesztési munkafolyamatát.

4. lépés: Határozza meg, milyen bizonyítékokra van szüksége

Kódmódosítások esetén adja meg a vonatkozó teszt-, build- vagy lint-parancsot, valamint azt a viselkedést, amelyet ellenőriznie kell. Kutatás céljából kérjen fájlhivatkozásokat vagy commit-azonosítókat. Felhasználói felületi munkákhoz adjon meg egy referencia képet és egy konfigurált módszert az implementáció ugyanazon a nézőtéren történő rögzítéséhez.

Kérje meg a Claude-ot, hogy jelentse, mit ellenőrzött valójában, beleértve a hibákat és az elhagyott ellenőrzéseket is. Ellenőrizze, hogy a bizonyítékok kielégítik-e a követelményeket; egy sikeres összeállítás még nem bizonyítja, hogy minden kért viselkedés működik.

Hosszabb feladatok esetén a Claude Code /goal feltételt és Stop hookokat is kínál. A célértékelő a beszélgetés során felszínre került bizonyítékokat értékeli, ahelyett, hogy önállóan vizsgálná a fájlokat vagy futtatná a teszteket. A beállított Stop hook megakadályozhatja a feladat befejezését, de a ismételt blokkolásnak vannak korlátai. Egyik sem helyettesíti a megfelelő teszteket és az emberi felülvizsgálatot.

5. lépés: Az ugyanazt a hibát folyamatosan megismétlő munkamenet visszaállítása

Ha az ismételt javítások sem oldják meg a problémát, állj meg, és derítsd ki, mi maradt tisztázatlan az eredeti kérésben. Mielőtt törölnéd a beszélgetést, mentsd el a hasznos megállapításokat, a Git aktuális állapotát és a hátralévő feladatokat.

Az Anthropic legjobb gyakorlatokról szóló útmutatója azt javasolja, hogy ha ugyanazon probléma megoldására tett két kísérlet sikertelen volt, kezdje elölről. Használja a /clear parancsot, majd adjon meg egy módosított utasítást, amely tartalmazza a tanulságokat. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Nyomd meg az Esc gombot a futó válasz megszakításához. Ha a parancssor üres, nyomd meg kétszer az Esc gombot a visszatekerés menü megnyitásához, és válaszd ki, mit szeretnél visszaállítani. A visszatekerés nem vonja vissza minden külső hatást, ezért használd a Git ellenőrzőpontjait és külön helyreállítási eljárásokat az adatbázisokban vagy távoli szolgáltatásokban végzett módosítások esetén.

Hová érdemes elmenteni az újrafelhasználható Claude-kód utasításokat?

Mentse el a projekt egészére vonatkozó útmutatásokat a CLAUDE.md fájlba, az ismétlődő eljárásokat a skills fájlokba, az egyes fájlokra vonatkozó utasításokat pedig az elérési út hatókörű szabályokba. Használjon hookokat az egyes eseményekhez kötött műveletekhez, például egy formázó futtatásához szerkesztés után.

Válasszon aszerint, hogy mikor kell az utasítást alkalmazni:

  • Egy útmutató: Használd az aktuális feladathoz, beleértve annak követelményeit, hatókörét és elfogadási kritériumait
  • CLAUDE.md: Használja projekt-szintű információkhoz, például build parancsokhoz, repository-konvenciókhoz és olyan korlátozásokhoz, amelyeket a Claude nem tud megbízhatóan kikövetkeztetni
  • Útvonal-hatályú szabályok: Olyan konvenciókhoz használja, amelyek bizonyos fájlokra vagy könyvtárakra vonatkoznak, például frontend-komponensekre vagy adatbázis-kódra.
  • Egy készség: Használja ismétlődő eljárásokhoz, például egy probléma kivizsgálásához vagy egy kiadás összefoglalójának elkészítéséhez.
  • Hook: Esemény által kiváltott műveletekhez vagy ellenőrzésekhez használható, például egy szerkesztett fájl formázásához vagy egy eszközhívás futtatás előtti ellenőrzéséhez.
  • Egy egyedi alügynök: Használja olyan speciális feladatokhoz, amelyeknél előnyös a saját utasítások, az eszközökhöz való hozzáférés és a külön kontextus, például egy célzott kódfelülvizsgálat esetén.

Tartsd külön a projektirányelveket a feladatleírásoktól

Egy funkcióra vonatkozó követelmény általában a hozzá tartozó feladatleírásban vagy specifikációban szerepel, nem pedig a CLAUDE.md fájlban. Ha ideiglenes utasításokat adunk hozzá egy projekt-szintű fájlhoz, azok nehezebben különböztethetők meg a teljes kódtárra érvényes konvencióktól.

Például tárold a projekt tesztparancsát a CLAUDE.md fájlban, helyezd el a komponensekre vonatkozó konvenciókat egy elérési út hatályú szabályba, és mentsd el az ismétlődő felülvizsgálati eljárást készségként. Ha a parancsok vagy a konvenciók megváltoznak, ellenőrizd ezeket a fájlokat, ahogyan azt a projekt egyéb dokumentációja esetében is tennéd.

Tegyen különbséget az útmutatás és a kényszerítés között

A promptok, a CLAUDE.md fájl és a készségek irányítják a Claude viselkedését; ezek azonban nem garantálják, hogy egy utasítást biztosan végrehajt. A hookok konfigurált eseményekkor ellenőrzéseket futtathatnak, de megbízhatóságuk a hook típusától és megvalósításától függ.

A parancs-hook egy szkriptet futtat. A prompt- vagy ügynök-hook egy modell ítéletére támaszkodik. Ahogyan az Anthropic legjobb gyakorlatokról szóló útmutatója kifejti: „A prompt- vagy ügynök-hook egy másik modellt kér meg a döntés meghozatalára, így ez sem determinisztikus.” Ha egy szabályt be kell tartatni, használjon megfelelő jogosultsági ellenőrzéseket, és tesztelje a vonatkozó parancs- vagy HTTP-hookot, beleértve azt is, hogyan kezeli a hibákat.

Az egyéni alügynökök egy másik módja az ismétlődő feladatok szervezésének. Ha különálló felülvizsgálati szerepkörre vagy eszközhatárokra van szükség, határozzon meg egy szakértőt a `.claude/agents/` könyvtárban, ahelyett, hogy minden szakértői utasítást a fő munkamenethez adna hozzá. Ezek az útmutatók a munkához legalkalmasabb Claude-modellről és az AI-ügynökök típusairól további háttérinformációkat nyújtanak.

Ha a csapata több AI-termékben is kezel promptokat, tekintse meg ezeket a prompt-tervező eszközöket a Claude Code-on túli könyvtárak kezeléséhez.

Gyakori hibák a Claude Code parancsoknál

Ha egy munkamenet hiányos vagy nem megfelelő eredményt hoz, ellenőrizze, hogy a kérés során maradtak-e megoldatlan fontos döntések. Ez az öt hiba megnehezítheti a munka diagnosztizálását és felülvizsgálatát.

1. Világos kérdés nélkül vizsgálatot kérni

A „Vizsgáld meg a lerakatot” utasítás nem ad elég iránymutatást a Claude-nak arról, hogy mely fájlok fontosak, illetve mikor kell abbahagynia a vizsgálatot. Előfordulhat, hogy egy általános összefoglalót kapsz, anélkül, hogy választ kapnál a kérés alapjául szolgáló problémára.

Nevezze meg azt a viselkedést vagy döntést, amelyet meg kell értenie, határozza meg a kiindulási pontot, és határozza meg a várt kimenetet. Például: „Kövesse nyomon, hogyan ellenőrzi ez az végpont a jogosultságokat, és sorolja fel a vonatkozó függvényeket.” Ha alügynököket használ, adjon mindegyiknek egy határolt kérdést, ahelyett, hogy ugyanazt a korlátlan keresést delegálná rájuk.

2. Össze nem függő feladatok keverése egy munkamenetben

Ha egy funkció, egy ahhoz nem kapcsolódó hiba és egy dokumentációs kérés között váltunk, a beszélgetés olyan kontextust hordoz, amely nem feltétlenül vonatkozik az aktuális feladatra. Az olyan hivatkozások, mint „az a fájl” vagy „a korábbi megközelítés”, kétértelművé válnak.

Használj külön munkameneteket az egymástól független feladatokhoz. Ha több munkamenet is szerkeszti a repositoryt, használj külön Git munkakönyvtárakat, hogy ne módosítsák ugyanazt a munkakönyvtárat. Egy rövid mellékes kérdés: a Claude Code /btw parancsa a fő beszélgetési előzményekből kizárja a cserét.

3. Olyan sikeres ellenőrzés elfogadása, amely nem fedi le a követelményt

Előfordulhat, hogy egy build sikeresen lefut, miközben egy funkció helytelenül viselkedik. Előfordulhat, hogy egy tesztcsomag sikeresen lefut, mert soha nem futtatta le a hibás bemenetet. Ha megkérjük Claude-ot, hogy „futtassa le a teszteket”, az nem jelenti azt, hogy kiderül, melyik követelményt ellenőrzik azok a tesztek.

Rendelje hozzá az elfogadási kritériumokat a konkrét ellenőrzésekhez. Hiba kijavítása esetén kérjen bizonyítékot arra, hogy a reprodukciós teszt a módosítás előtt sikertelen volt, utána pedig sikeres lett. Tartsa szem előtt a még nem tesztelt kritériumokat, ahelyett, hogy egyetlen sikeres parancsot venné a teljes módosítás igazolásának.

4. További utasítások hozzáadása az ütközések megoldása nélkül

Egy folyamatosan bővülő CLAUDE.md fájl elavult parancsokat, ismétlődő szabályokat és a feladatspecifikus követelményekkel ellentmondó utasításokat tartalmazhat. Ezeket az ellentmondásokat nem oldja meg a szöveg szigorúbb megfogalmazása.

Hasonlítsa össze a fájlt az aktuális kódtárral. Távolítsa el az elavult útmutatásokat, tisztázza az egymással ütköző szabályokat, és helyezze át a szűk körben alkalmazható utasításokat útvonal-hatályú szabályokba vagy készségekbe. Ha egy követelmény betartatására van szükség, konfigurálja és tesztelje a megfelelő ellenőrző mechanizmusokat, ahelyett, hogy ismételt emlékeztetőkre támaszkodna.

5. Minden felülvizsgálat során feltárt problémát tekintsünk megerősített hibának

Egy kódáttekintés során egyszerre derülhetnek ki valódi hibák, bizonytalan problémák és opcionális refaktorálási javaslatok. Az összes javaslat alkalmazása megnövelheti a változtatások mértékét anélkül, hogy javítaná a kívánt viselkedést.

Kérdezze meg az egyes megállapítások mögött álló bizonyítékokat és hatásokat. Rangsorolja a helyességi problémákat és a nem teljesített követelményeket, vizsgálja meg a bizonytalan állításokat, és tartsa távol a jelenlegi diff-től a nem kapcsolódó fejlesztéseket. A felülvizsgálónak képesnek kell lennie arra, hogy ne jelentsen cselekvésre okot adó megállapításokat, ha a bizonyítékok ezt a következtetést támasztják alá.

Hogyan használhatod a ClickUp-feladatokat Claude-kód-feladatleírásként

Ha egy funkciókéréshez már vannak elfogadott követelmények a ClickUp-ban, használd azt a feladatot a Claude Code feladatleírásaként. Tartsd egy helyen a várt viselkedést, a korlátozásokat és az elfogadási kritériumokat, hogy a megvalósítást ugyanazon kérés alapján lehessen ellenőrizni.

Kétféle módon kapcsolhatja össze ezt a feladatleírást a fejlesztési munkával: elolvashatja azt egy Claude Code-munkamenetből a ClickUp MCP-n keresztül, vagy hozzárendelheti egy ClickUp Cloud Agenthez. Ezek különálló munkafolyamatok.

A ClickUp MCP segítségével vigye át a feladat követelményeit a Claude Code-ba

A Claude felülete, amelyen egy „Web UI” nevű ClickUp-feladat létrehozására vonatkozó jóváhagyási kérelem látható, az Elutasítás, Mindig engedélyezés és Egyszeri engedélyezés opciókkal.
Ellenőrizze a javasolt ClickUp-feladatot, mielőtt engedélyezné Claude-nak, hogy az MCP-n keresztül létrehozza azt.

A ClickUp MCP-kiszolgáló lehetővé teszi a Claude Code számára, hogy a fiókod jogosultságait felhasználva hozzáférjen a támogatott ClickUp-eszközökhöz. Lekérheted a feladatok részleteit és a vonatkozó kontextust, majd a Claude Code tárolóeszközeit használva megvizsgálhatod a fájlokat, módosításokat végezhetsz és teszteket futtathatsz. Az MCP hozzáférést biztosít a ClickUp-hoz; maga nem végzi el a helyi kódolási munkát.

Kövesse a súgó útmutatásait, hitelesítse fiókját, és nyissa meg a megfelelő tárolót a Claude Code-ban. A megvalósítás előtt ellenőrizze, hogy a feladat pontosan meghatározza-e a kívánt viselkedést, a releváns korlátokat és az elfogadási kritériumokat. Az Anthropic MCP útmutatónk elmagyarázza, hogyan működik a kapcsolat.

Például egy pénztári feladat esetében előfordulhat, hogy a lejárt kuponoknál hibaüzenet jelenjen meg anélkül, hogy megrendelés jönne létre, míg az érvényes kuponok továbbra is működnek. Egy szemléltető utasítás így hangozhat:

  • Használja a ClickUp MCP-t a [feladat-azonosító vagy URL] beolvasásához, majd foglalja össze annak követelményeit, korlátait és elfogadási kritériumait. Ellenőrizze, hogy a munkamenetben szereplő tároló és ág megfelel-e a feladatnak.
  • Vizsgálja meg a vonatkozó kódot, és javasoljon olyan tervet, amely minden elfogadási kritériumot egy megvalósítási lépéshez és egy teszthez rendel. Jelölje meg a hiányzó vagy egymással ütköző követelményeket, és a szerkesztés előtt várja meg a jóváhagyást.
  • A jóváhagyás után hajtsa végre a megegyezés szerinti változtatásokat, és futtassa a [tesztparancs] parancsot. Jelentse a ténylegesen elvégzett ellenőrzéseket, azok eredményeit, valamint mindazt, ami még nem került ellenőrzésre.
  • Írj egy feladatmegjegyzést, amely összefoglalja a változtatásokat, a kritériumonkénti eredményeket és a PR-linket, ha van ilyen. Mutasd meg nekem, mielőtt közzéteszed. Ne egyesítsd a változtatásokat.

A megvalósítás elfogadása előtt vizsgáld át a diff-et és a tesztelési eredményeket. A jóváhagyás után add hozzá az eredményeket és a PR-linket a feladathoz, hogy a felülvizsgálók nyomon követhessék a munkát az eredeti kérésétől a javasolt módosításig.

Rendelje a meghatározott feladatokat egy ClickUp Cloud Agenthez

A „Code Review” feladat a ClickUp-ban a Code Agentnek van hozzárendelve, egy beszélgetés mellett, amelyben a Cloud Agent felajánlja, hogy elindít egy munkamenetet, és visszaküld egy pull requestet.
Rendeljen feladatot egy ClickUp Cloud Agentnek, és kövesse nyomon a feladat szálában a haladást.

A ClickUp Cloud Agents külön lehetőséget kínál a feladatok feldolgozására anélkül, hogy helyi Claude Code-munkamenetet kellene futtatni. Csatlakoztasd a GitHubot, válaszd ki vagy erősítsd meg a repositoryt, majd rendeld hozzá a feladatot. Az ügynök elolvassa a feladatleírást, a felhőben dolgozik, majd pull requestet küld vissza a feladat szálába.

Alkalmazzon egységes minőségi mércét a feladatra: magyarázza el a várt viselkedést, határozza meg a korlátokat, és tegye felülvizsgálhatóvá az elfogadási kritériumokat. A diff-et továbbra is egy személy vizsgálja át és ellenőrzi, mielőtt jóváhagyná az összevonást. A visszaküldött PR felülvizsgálatra szóló javaslat, nem pedig annak bizonyítéka, hogy minden követelmény teljesült.

Válassza ki azt a munkafolyamatot, amely leginkább megfelel a munka felügyeletére vonatkozó elképzeléseinek. Az MCP segítségével bevonhatja a ClickUp kontextusát a Claude Code munkamenetébe; a Cloud Agents segítségével pedig a ClickUp-on keresztül delegálhat feladatokat, és ott is áttekintheti a visszaküldött munkát. Egyik sem szünteti meg azonban a kétértelmű feladatleírások tisztázásának szükségességét.

Készítsen utasításkönyvtárat az általa áttekintett munkákból

A fenti 25 útmutató kiindulási pontként szolgál. Használatuk során tartsa meg azokat a változatokat, amelyek illeszkednek a kódtárához, és jegyezze fel, mit kellett tisztáznia: egy hiányzó üzleti szabályt, egy váratlan függőséget vagy egy olyan tesztet, amely nem fedte le a követelményt.

Ezek a javítások még hasznosabbá teszik az újrafelhasználható utasítást a csapatod számára. Frissítsd, ha a kód vagy a munkafolyamat megváltozik, és tartsd szem előtt a megoldatlan korlátozásokat, hogy a következő személy tudja, hol van még szükség felülvizsgálatra.

Ha a munka a ClickUp-ban kezdődik, csatold a feladathoz a követelményeket, a döntéseket és a megvalósítás eredményeit. Így a következő fejlesztő vagy ügyintéző számára nyomon követhető lesz, hogy mit kértek, mi változott és mi maradt nyitott kérdésként.

Gyakran feltett kérdések a Claude Code-utasításokról

Mi az a „Plan” mód a Claude Code-ban?

A Tervezési módban a Claude fájlokat vizsgálhat és írásvédett parancsokat futtathat, hogy a forráskód szerkesztése nélkül elkészítse a megvalósítási tervet. Nyomja meg a Shift+Tab billentyűkombinációt, amíg meg nem jelenik a Tervezési mód, vagy indítson munkamenetet a claude --permission-mode plan paranccsal. A megvalósítás jóváhagyása előtt tekintse át a javasolt megközelítést; a Ctrl+G billentyűkombinációval megnyithatja a javasolt tervet a szerkesztőjében.

Hogyan adhatok hozzá új sort egy Claude Code parancsba?

Nyomja meg a Ctrl+J billentyűkombinációt, vagy írjon be egy háttérszlást (\), majd nyomja meg az Enter billentyűt. Mindkét módszer további beállítás nélkül működik a terminálokon. A Shift+Enter billentyűkombináció is működik a támogatott terminálokon; egyes integrált terminálok esetében először futtatni kell a /terminal-setup parancsot. Ellenőrizze a környezetéhez tartozó terminálkonfigurációs útmutatót.

Hogyan javíthatom ki a „A parancs túl hosszú” hibát a Claude Code-ban?

Csökkentse a beszélgetés során elküldött tartalom mennyiségét. Ha egy munkamenet elérte a kontextuskorlátot, a /compact parancs összefoglalja a történetet, míg a /clear parancs új beszélgetést indít. Ha egy túl nagy üzenetet nem lehet tömöríteni, rövidítse le, vagy adjon meg belőle kiválasztott részleteket. Nagy fájlok esetén kérje meg Claude-ot, hogy vizsgáljon meg konkrét szakaszokat a teljes tartalom betöltése helyett. A beszélgetés törlése nem vonja vissza a fájlokban végzett módosításokat.

Megváltoztathatom a Claude Code rendszerparancsát?

Igen. A --append-system-prompt CLI-jelző az alapértelmezett rendszerparancssorhoz utasításokat fűz hozzá, míg a --system-prompt teljesen felváltja azt. A hozzáfűzés megőrzi az alapértelmezett utasításokat; a felváltás nagyobb odafigyelést igényel, mivel azok az utasítások már nem szerepelnek benne. Ismétlődő repository-konvenciók esetén a CLAUDE.md fájl általában praktikusabb választás. Egyik megközelítés sem helyettesíti a konfigurált jogosultsági beállításokat. A támogatott opciókat lásd a CLI-referenciában.

Használhatják a Claude Code-parancsokat azok is, akik nem programoznak?

Igen. A Claude Code segítséget nyújthat olyan feladatokban, mint a fájlok összehangolása, jelentések generálása és dokumentumok megszövegezése helyi forrásokból. Az üzleti szabályokat továbbra is Önnek kell meghatároznia, és a kimenetet is Önnek kell ellenőriznie. Kezdje jóváhagyott adatok másolataival és olyan eredménnyel, amelyet önállóan ellenőrizni tud. Ha a feladat olyan kódot eredményez, amelyet nem tud értékelni, kérjen fel egy képzett ellenőrt, mielőtt azt éles adatokkal vagy rendszerekkel használná.