Úvod: Kód sa nestará o vaše pocity
Ide o to, že rozsiahle jazykové modely a kód: sú prekvapivo sebavedomé a úplne ľahostajné k tomu, či sa váš program kompiluje. Claude Haiku 4.5 vám rád napíše skript v jazyku Python, ktorý vyrieši váš problém, plus dva, ktoré si vymyslel pre zábavu. Trikom – jediným trikom, na ktorom záleží – je naučiť sa, ako zadávať požiadavky pre Claude Haiku 4.5 na presné generovanie kódu spôsobom, ktorý neponecháva žiadny priestor pre pocity a maximálny priestor pre pravdu. Nechcete prózu, ktorá znie ako kód. Chcete kód, ktorý sa správa ako kód. Je v tom rozdiel.
Ľudia sa k zadávaniu požiadaviek správajú ako k mystickému zaklínadlu – povedzte správne slová a získajte dokonalú aplikáciu. To je cargo kult myslenie. Kód je zmluva. Ak chcete od Claude Haiku presnosť, musíte napísať zmluvu. „Vytvorte webovú aplikáciu“ nie je zmluva. „Vygenerujte koncový bod FastAPI v jazyku Python 3.12, ktorý akceptuje JSON, validuje schému pomocou Pydantic v2 a v prípade chýb schémy vráti 422 so špecifickým formátom payloadu“ je zmluva. Takto sa zadávajú požiadavky pre Claude Haiku 4.5 na presné generovanie kódu: definujete zmluvu.
Čo to je (a čo nie)
- Je to návod, ako získať spoľahlivý, testovateľný kód od Claude Haiku 4.5.
- Nie je to kázeň o „AI nahrádzajúcej vývojárov“. Nástroje nenahrádzajú myslenie.
- Je zameraný na praktické požiadavky, štruktúru a mantinely: nudné časti, ktoré umožňujú fungovanie mágie.
Ak chcete kód, ktorý beží, musíte dať Claudovi funkčnú definíciu slova „beží“. Ak chcete presné generovanie kódu, musíte definovať presnosť jasnými, testovateľnými pojmami. To je celá hra.
Definujte presnosť ako právnik, nie ako básnik
„Presný“ kód nie je kód, ktorý „vyzerá uveriteľne“. Presnosť je:
- Syntaktická platnosť: kompiluje sa alebo beží pod interpretom.
- Sémantická vernosť: robí to, čo hovorí špecifikácia.
- Deterministické správanie: rovnaké vstupy, rovnaké výstupy, v rámci definovaných hraníc chýb.
- Správnosť verzie: používa správne SDK, verzie API a jazykové funkcie.
Claude vám dá, o čo požiadate. Ak požiadate o „funkciu, ktorá zoradí zoznam“, pravdepodobne ju dostanete. Ak požiadate o „stabilné, triedenie na mieste pomocou sémantiky Timsort s extra priestorom O(1)“, to je iný sľub. „Ako zadávať požiadavky pre Claude Haiku 4.5 na presné generovanie kódu“ začína zapísaním týchto sľubov do požiadavky.
Minimálna životaschopná požiadavka, vylepšená
Zlé: „Napíšte Node API pre úlohy.“
Lepšie: „Napíšte Node 20 Express 4 API s trasou /tasks POST, ktorá validuje polia {title: string, dueDate: ISO 8601} a odpovedá 201 s vytvoreným objektom alebo 400 s podrobnosťami o chybe.“
Správne: „Vygenerujte server Node 20 Express 4 s jedným koncovým bodom /tasks POST. Požiadavky: 1) Validujte telo pomocou [email protected]; 2) Polia: title (neprázdny reťazec, max 140), dueDate (dátum ISO 8601 v budúcnosti); 3) Pri úspechu: 201 s {id: ULID, title, dueDate}; 4) Pri neplatnom: 400 s {error: 'VALIDATION', details: array}; 5) Žiadna databáza; in-memory Map; 6) Zahrňte testovací súbor Jest 29 pokrývajúci platné, neplatné (prázdny názov, minulý dátum); 7) Poskytnite npm skripty pre test a vývoj; 8) Použite ESM; 9) Nezahŕňajte nadbytočné komentáre.“ Všimnite si tvar: verzia jazyka, knižnice, obmedzenia, výstupy, chyby, testy a dokonca aj štruktúra balíka. Odstránili ste nejednoznačnosť. Úlohou Claude je vyplniť kód, nie požiadavky.
Šablóna lešenia: Systém, špecifikácia, testy, potom kód
Ak chcete presné generovanie kódu od Claude Haiku 4.5, musíte mu dať priestor:
- Rámec systému (krátke vodítko)
- Vy: „Píšete TypeScript v produkčnej kvalite pre Node 20. Vypíšte iba bloky kódu s názvami súborov a nič iné.“
- Prečo: Kontrolujete tón a formát výstupu. Neponechávajte to na náhodu.
- Zahrňte verzie jazyka, výber balíkov, sémantiku chýb, formáty I/O, limity výkonu a bezpečnostné obmedzenia.
- Povedzte Claudovi, aby najprv napísal unit testy. Testy definujú „presnosť“ lepšie ako prídavné mená. Ak riadok kódu neslúži testu, je ozdobný.
- Až po testoch. Áno, je to v podstate TDD, ale s robotom, ktorý sa nikdy nenudí písať boilerplate.
- Pokyny pre opakované spustenia
- „Ak testy zlyhajú alebo sa nezhodujú importy, aktualizujte iba zlyhávajúce časti. Neprepisujte celý projekt.“
Claudovi sa darí dobre, keď má kontext a mantinely. Dajte mu mantinely.
Pripnutie verzie nie je voliteľné
Školiace údaje Claude sú plné starých a nových dokumentov. To je zdvorilý spôsob, ako povedať, že videl veľa protichodných rád. „Použite React Router“ je vágne. „Použite [email protected] s dátovými smerovačmi“ je smerovanie. Neverte predvoleným hodnotám: - Jazyky: pripnite na Python 3.12, Node 20, Go 1.22, Java 21 – čokoľvek, čo skutočne spúšťate.
- Frameworky: uveďte presné hlavné verzie a všetky príznaky meniace zmeny.
- Cloud SDK: pripnite verzie; aws-sdk v2 vs v3 záleží.
- Lintery/formátovače: uveďte pravidlá, aby ste sa vyhli prepisovaniam „style ping-pong“.
Ak nepripnete, získate najväčšie hity z piatich rokov blogových príspevkov. Presné generovanie kódu je alergické na nostalgiu.
Najprv schéma, vždy
Nepýtajte sa na štruktúry „používateľského profilu“. Definujte schémy v požiadavke a vyžadujte validáciu:
- Typy JSON Schema alebo Zod/Yup v JS/TS
- Modely Pydantic v jazyku Python
- Protobuf alebo Avro pre služby
Potom prinúťte Claude presadzovať schémy na hraniciach – vstupy API, zápisy do databázy a fronty správ. Požiadajte o explicitné chybové payloady a kódy. Presnosť miluje schémy. Nejednoznačnosť nie.
Urobte to pozorovateľným, alebo sa nehrajte, že je to skutočné
Povedzte Claudovi, aby pridal protokolovanie, metriky a stopy tam, kde ich potrebujete – a aby ich udržal ticho tam, kde ich nepotrebujete. Dobrá požiadavka obsahuje:
- Zásady protokolovania: úrovne, redakcia PII, štruktúra (protokoly JSON, prosím)
- Metriky: čas na požiadavku, počet chýb
- Koncové body stavu: /healthz, ktoré dokazujú, že závislosti sú aktívne
Claude pridá, o čo požiadate. Ak sa nepýtate, získate príkazy print – ak budete mať šťastie.
Požiadavky testami na prvom mieste porážajú „Len mi verte“
Dobrý spôsob, ako zadať požiadavku pre Claude Haiku 4.5 na presné generovanie kódu, je urobiť z testov zdroj pravdy. Príklad:
„Napíšte pytest testy pre funkciu normalize_email(s), ktorá:
- prevedie lokálnu a doménovú časť na malé písmená;
- odstráni bodky v lokálnej časti iba pre gmail.com;
- odstráni podadresy (+tag) iba pre gmail.com;
- odmietne vstupy bez jediného @ alebo s medzerami;
- zachová unicode doménový punycode tak, ako je.
Pokryte okrajové prípady. Po napísaní testov implementujte funkciu, aby ich úspešne absolvovala.“
Claude často píše lepší kód, keď je nútený uspokojiť testy, ktoré ste opísali. Ak to tak nie je, máte konkrétne zlyhanie, nie argument o pocitoch.
Žiadne halucinácie podľa konštrukcie
Nemôžete eliminovať halucinácie, ale môžete ich ohradiť:
- Požiadajte o citácie alebo zdrojové adresy URL iba vtedy, keď existujú zdroje. Pre metódy SDK požadujte odkazy na dokumenty a vyžadujte, aby sa kód zhodoval s týmito dokumentmi.
- Pre súkromné API vložte špecifikáciu do požiadavky. Neočakávajte, že Claude pozná vaše interné koncové body.
- Pre knižnice s mätúcimi API zahrňte ukážkový fragment z oficiálnych dokumentov a povedzte Claudovi, aby sa ich držal.
Presný kód sú väčšinou presné referencie. Dajte Claudovi referencie.
Sprievodcovia štýlom: Najmenej sexy, najužitočnejšia vec
Claude píše kód v akomkoľvek štýle, ktorý odvodí. To je recept na churn. Vložte svojho sprievodcu štýlom. Uveďte:
- Formátovanie (Prettier, Black, gofmt default)
Požadujte tiež krátky komentár s odôvodnením pre nezjavné voľby. Budúci vy sa vám poďakujú a súčasný Claude vytvorí menej PR „fix-up“.
Dlhé požiadavky, krátke výstupy
Ďalší spôsob, ako premýšľať o tom, ako zadať požiadavku pre Claude Haiku 4.5 na presné generovanie kódu: venujte svoje slová požiadavke, nie výstupu. Chcete:
- Vyčerpávajúce obmedzenia v požiadavke
- Minimálna nadbytočná narácia vo výstupe
Povedzte mu, aby potlačil vysvetlenia a vrátil iba bloky kódu s názvami súborov a krátkym súborom README. Ak chcete komentár, požiadajte oň v samostatnom spustení. Prelínanie prózy a kódu je spôsob, ako sa do nich vkrádajú chyby v monokle a cylindri.
Vylepšenie: Tesná slučka, ktorá skutočne funguje
Najrýchlejšia cesta k spoľahlivému kódu nie je „dostať to na prvý pokus správne“. Sú to krátke, opravné slučky:
- Spustite lokálne. Vložte zlyhávajúci výstup testu a chyby kompilátora späť do Claude verbatim.
- Inštruujte: „Upravte iba minimálny potrebný počet riadkov; nemeňte podpisy funkcií, pokiaľ to nevyžadujú zlyhávajúce testy.“
- Opakujte, kým nebude zelená.
Claude je vynikajúci v aplikovaní rozdielov, keď mu presne poviete, čo sa pokazilo. Neparafrázujte protokoly zlyhania. Vložte ich. Protokoly sú pravda.
Zabezpečenie je funkcia, nie doslov
Pretože modely sú trénované na verejnom kóde (dobrý, zlý a prekliaty), chcete, aby bolo zabezpečenie prvoradou požiadavkou:
- Výslovne zakážte eval, shell=True a reťazcové SQL
- Vyžadujte parametrizované dotazy, ochranu CSRF a obmedzenie rýchlosti
- Požiadajte o pripnutie závislostí plus uzamykací súbor
- Vyžadujte spracovanie tajomstiev prostredníctvom premenných prostredia alebo správcu tajomstiev
Požiadavka zabezpečená v predvolenom nastavení prináša bezpečnejší kód. Požiadavka „opravíme to neskôr“ prináša titulky.
Výkon: Povedzte, čo znamená „rýchly“
„Urobte to rýchlo“ sa prekladá ako „robte, čo chcete“. Namiesto toho uveďte metriky:
- Ciele latencie (p95 < 50 ms pre in-memory, p95 < 300 ms pre DB operácie)
- Limity pamäte (RSS < 150 MB)
- Časová zložitosť (musí byť O(n log n), nie O(n^2))
Claude si vyberie algoritmy, ktoré zodpovedajú vášmu rozpočtu. Dajte mu rozpočet.
Dokumentácia: Dosť na to, aby sa nalodil cudzinec
Požiadajte Claude o súbor README, ktorý obsahuje:
- Pokyny na nastavenie s presnými verziami
- Príkazy pre test, lint, typecheck, run
- Príklady požiadaviek/odpovedí
- Obmedzenia a známe kompromisy
„Presný kód“ zahŕňa presné dokumenty. Sú súčasťou dodávky.
Konkrétne šablóny požiadaviek, ktoré si môžete ukradnúť
Šablóna: Backend Endpoint
Systém: Ste dôkladný inžinier Python 3.12. Vypíšte iba bloky kódu s názvami súborov.
Používateľ:
- Vytvorte aplikáciu FastAPI 0.111 s koncovým bodom POST /convert.
- Požiadavka: {amount: Decimal as string, from: 'USD'|'EUR', to: same}.
- Validujte pomocou pydantic v2; vráťte tvar 422 pri chybách schémy.
- Použite čistú funkciu convert(amount, from, to) s pevnými sadzbami {USD:1, EUR:1.1}.
- Vráťte {amount: string, currency: string} s 200.
- Zahrňte pytest testy pokrývajúce platné, neplatné (zlý desatinný, neznámy kód) a edge (0).
- Poskytnite pyproject.toml s pripnutými závislosťami; zahrňte konfigurácie ruff a mypy.
- Žiadne sieťové volania, žiadne komentáre.
Šablóna: CLI Utility
Systém: Píšete Go 1.22. Vypíšte iba bloky kódu s názvami súborov.
Používateľ:
- Vytvorte CLI s názvom slugify, ktorý číta stdin a tlačí URL-safe slugy.
- Pravidlá: malé písmená, iba ASCII, oddeľovače pomlčiek, zrútenie medzier, odstránenie interpunkcie.
- Poskytnite main.go a slugify_test.go s tabuľkovými testami.
- Zahrňte Makefile s cieľmi testu a zostavenia.
Šablóna: Frontend Component
Systém: Ste pragmatický React inžinier zameraný na React 18 + TypeScript.
Používateľ:
- Implementujte komponent <DebouncedInput>.
- Props: value: string, onChange(value): void, delay=300.
- Použite useRef/useEffect; žiadne háčiky tretích strán.
- Zahrňte vitest testy s falošnými časovačmi.
- Poskytnite minimálny Storybook príbeh.
Tieto šablóny demonštrujú, ako zadať požiadavku pre Claude Haiku 4.5 na presné generovanie kódu pripnutím verzií, definovaním správania a vyžadovaním testov.
Odmietnutie byť chytrý: Kedy povedať „Neoptimalizovať“
Ak nechcete predčasné mikro-optimalizácie (a nechcete), povedzte to:
- „Uprednostňujte čitateľnosť pred chytrosťou; žiadne bit-twiddling, pokiaľ to testy nevyžadujú.“
- „Žiadna rekurzia, ak je iteratívna jasnejšia.“
- „Žiadne metaprogramovanie; explicitné > implicitné.“
Claude rád robí dojem. Nedovoľte mu to. Nechajte ho úspešne absolvovať testy a byť čitateľný. To je dosť pôsobivé.
Sider.AI v pracovnom postupe, kde skutočne pomáha Videl som ľudí žonglovať s požiadavkami v náhodných kartách chatu, ako keby to bol rituál produktivity. Použite pracovný priestor, ktorý rozumie kontextu kódu. Napríklad Sider.AI je postavený na udržiavaní vašej špecifikácie, kódu, rozdielov a protokolov testov na dohľad, takže slučka „vložiť chybu, opraviť riadok“ je skutočne tesná. Nie je to mágia; je to nudné lešenie, ktoré vám zabráni stratiť dej. Ak váš nástroj uchováva zmluvu, testy a kód v rovnakej konverzácii – bez toho, aby vás otravoval konfetami – použite ho. Sider to robí. Ako ladiť s Claude ako spoluhráčom, nie ako veštec
- Vložte zlyhávajúci výstup testu presne tak, ako je. Nezhŕňajte.
- Požiadajte o diff: „Odpovedzte jednotným rozdielom iba pre súbor X.“
- Pre chyby runtime pridajte najmenší reprodukovateľný fragment a požadujte vysvetlenie plus opravu.
- Pre chyby knižnice vložte výňatok z dokumentu, o ktorom si myslíte, že platí, a opýtajte sa: „Je toto správne API pre verziu X? Ak nie, aktualizujte kód a uveďte správny výňatok.“
Cieľom je prinútiť Claude argumentovať s dôkazmi. Vy prinášate dôkazy.
Prehliadka úskalí (a ako sa im vyhnúť)
- Pasca „najnovšieho“ API: Nehovorte „použite najnovšie“. Povedzte „použite verziu X.Y“ a držte sa jej.
- Prázdny testovací súbor: Ak nepožadujete testy, nezískate ich.
- Klam jednostrannosti: Plánujte dve alebo tri krátke vylepšenia. Je to rýchlejšie ako jedna nafúknutá požiadavka.
- Nejednoznačná politika chýb: Definujte stavové kódy a payloady. „Vrátiť chybu“ neznamená nič.
- Nevlastnená závislosť: Ak sa kód spolieha na službu, ktorú nemôžete ovládať, stub ju. Požiadajte o fakes.
Váš kontrolný zoznam požiadaviek (prilepte si ho k monitoru)
- Verzia jazyka a runtime pripnutá
- Definovaná sémantika chýb (kódy, tvary)
- Výslovné bezpečnostné obmedzenia
- Špecifikovaný štýl a štruktúra
- Obmedzený formát výstupu (názvy súborov, bloky kódu, rozdiely)
- Krátka slučka vylepšenia s vloženými protokolmi
Ak splníte všetkých desať, Claude Haiku 4.5 vo všeobecnosti produkuje presné generovanie kódu, ktoré prežije denné svetlo.
Pracovný príklad: Od vágneho k overenému
Vágna požiadavka: „Napíšte funkciu na bezpečné parsovanie CSV.“
Výsledok: Pravdepodobne v poriadku, pravdepodobne nesprávny, určite netestovaný.
Presná požiadavka:
„Píšete Python 3.12. Vypíšte iba bloky kódu s názvami súborov.
Vytvorte csvsafe/init.py a csvsafe/reader.py s funkciou read_rows(path: Path) -> list[dict[str,str]]. Požiadavky: použite csv.DictReader s newline='' a encoding='utf-8'; zakážte nulové bajty; odmietnite súbory >10MB; obmedzte stĺpce na 100; odstráňte BOM; zaobchádzajte s prázdnymi bunkami ako s prázdnymi reťazcami; vyvolajte ValueError s kódmi správ {FILE_TOO_LARGE, NULL_BYTE, TOO_MANY_COLUMNS}. Zahrňte testy v tests/test_reader.py s pytest pokrývajúcimi šťastnú cestu, nulový bajt, 11MB súbor, 101 stĺpcov a spracovanie BOM. Poskytnite pyproject.toml s pripnutými závislosťami a čiernou konfiguráciou.“
Získate kód, testy a spracovanie okrajov. Potom spustíte testy, vložíte zlyhania a iterujete s minimálnymi rozdielmi. To je presné generovanie kódu v praxi.
O „kreativite“ a iných marketingových slovách
Nepotrebujem „kreatívny“ kód. Potrebujem správny kód. Šetrite kreativitu na pomenovanie svojej mačky. Pri zadávaní požiadaviek pre Claude je kreativita prirodzeným vedľajším produktom pevných obmedzení. Správne testy a jasné špecifikácie produkujú elegantné riešenia. Nesprávna požiadavka produkuje „preinventovaný base64 s emojis“. Nepokúšajte to.
Ne-tajný tajomstvo
Spôsob, ako zadať požiadavku pre Claude Haiku 4.5 na presné generovanie kódu, je nudný: zapíšte si, čo potrebujete, pripnite verzie, definujte schémy, požadujte testy a iterujte so skutočnými zlyhaniami. To je všetko. Žiadny mysticizmus. Iba inžinierska disciplína s modelom, ktorý dokáže veľmi rýchlo písať a nevadí mu písať pätnásť takmer identických testovacích prípadov.
A to je zvrat: presnosť je neokázalá. Požiadavky, ktoré fungujú, sa čítajú ako kontrolný zoznam TSA. Kód, ktorý sa dodáva, sa číta, ako keby ho napísal človek, ktorému na ňom záležalo. Oboje získate tak, že sa k modelu správate ako k mladšiemu inžinierovi, ktorému sa darí pri jasných požiadavkách a vädne pri vágnom smerovaní. Dajte mu zmluvu. Nechajte ho úspešne absolvovať testy. Potom mu možno môžete dôverovať – s takou dôverou, akú dávate nástroju, nie prorokovi.
Záver: Menej kúziel, viac záruky
Ak chcete kúzelníctvo, choďte na kúzelnícku šou. Ak chcete softvér, ktorý sa kompiluje a správa, píšte požiadavky, ktoré fungujú ako záruky. Ako zadať požiadavku pre Claude Haiku 4.5 na presné generovanie kódu nie je o kvetnatých frázach alebo tajných kľúčových slovách. Je to o obmedzeniach, testoch, verziách a slučkách spätnej väzby. Urobte tieto štyri veci a získate kód, ktorý beží. Vynechajte ich a získate krásne formátovanú fikciu.
Kód sa nestará o tvoje pocity. Našťastie, ani testy.
FAQ
Otázka 1: Aký je najjednoduchší spôsob, ako Claude Haiku 4.5 podnietiť k presnému generovaniu kódu?
Berte to ako zmluvu: pevne stanovte verzie, definujte schémy, špecifikujte formáty chýb a najprv vyžadujte testy. Čím jasnejšie sú obmedzenia, tým presnejší je kód.
Otázka 2: Ako znížim halucinácie, keď Claude píše kód?
Vložte smerodajné dokumenty alebo špecifikácie a vyžadujte presné dodržiavanie týchto API. Pre súkromné koncové body zahrňte svoju vlastnú špecifikáciu – neočakávajte, že bude hádať.
Otázka 3: Mám požiadať Claudea o testy alebo si ich mám napísať sám?
Najprv požiadajte Claudea, aby vygeneroval testy, a potom implementujte kód, ktorý ich uspokojí. Testy definujú presnosť lepšie ako prídavné mená a udržujú model čestný.
Otázka 4: Aká špecifická by mala byť fixácia verzií vo výzvach?
Veľmi špecifická: runtime jazyka, hlavná/vedľajšia verzia frameworku a verzie SDK. „Najnovšie“ pozýva konfliktné vzory; presnosť závisí od stabilných cieľov.
Otázka 5: Ako zapadá Sider.AI do podnetov pre presný kód?
Používajte Sider.AI na uchovávanie špecifikácií, kódu, rozdielov a protokolov testov v jednom cykle. Nerobí to žiadne kúzla – iba zachováva kontext, aby Claudeove opravy sledovali vaše skutočné zlyhania. 
