Úvod: Kódu je jedno, jaké máte nálady
S velkými jazykovými modely a kódem je to takto: jsou až překvapivě sebevědomé a naprosto lhostejné k tomu, zda se váš program zkompiluje. vám s radostí napíše skript, který vyřeší váš problém, a k tomu ještě dva, které si vymyslel pro zábavu. Tri trik – jediný trik, na kterém záleží – je naučit se, jak zadávat podněty pro přesnou generaci kódu tak, aby nezbyl žádný prostor pro dojmy a maximální prostor pro fakta. Nechcete text, který zní jako kód. Chcete kód, který se chová jako kód. Je v tom rozdíl.
Lidé se k zadávání podnětů chovají jako k mystickým zaklínadlům – řekněte správná slova a získáte dokonalou aplikaci. To je myšlení cargo kultu. Kód je smlouva. Chcete-li od přesnost, musíte tu smlouvu napsat. „Vytvořte webovou aplikaci“ není smlouva. „Vygenerujte endpoint v , který přijímá , validuje schéma pomocí a v případě chyb schématu vrací se specifickým formátem payloadu“ je smlouva. Takto se zadávají podněty pro přesnou generaci kódu: definujete smlouvu.
Co to je (a co není)
- Je to návod, jak získat spolehlivý, testovatelný kód od .
- Není to kázání o „AI nahrazující vývojáře“. Nástroje nenahrazují myšlení.
- Zaměřuje se na praktické podněty, strukturu a mantinely: nudné části, díky kterým funguje magie.
Chcete-li kód, který běží, musíte dát funkční definici toho, co znamená „běží“. Chcete-li přesnou generaci kódu, musíte definovat přesnost jasnými, testovatelnými termíny. O tom to celé je.
Definujte přesnost jako právník, ne jako básník
„Přesný“ kód není kód, který „vypadá věrohodně“. Přesnost je:
- Syntaktická validita: kompiluje se nebo běží pod interpretrem.
- Sémantická věrnost: dělá to, co říká specifikace.
- Deterministické chování: stejné vstupy, stejné výstupy, v rámci definovaných chybových mezí.
- Správnost verze: používá správné SDK, verze API a jazykové prvky.
vám dá to, o co požádáte. Pokud požádáte o „funkci, která seřadí seznam“, pravděpodobně ji dostanete. Pokud požádáte o „stabilní řazení na místě pomocí sémantiky s extra prostorem “, je to jiný slib. „Jak zadávat podněty pro přesnou generaci kódu“ začíná zapsáním těchto slibů do podnětu.
Minimální životaschopný podnět, vylepšený
Špatně: „Napište pro úkoly.“
Lépe: „Napište s trasou , která validuje pole {title: string, dueDate: } a odpovídá s vytvořeným objektem nebo s podrobnostmi o chybě.“
Správně: „Vygenerujte server s jedním endpointem . Požadavky: 1) Validujte tělo pomocí ; 2) Pole: title (neprázdný řetězec, max. 140), dueDate ( datum v budoucnosti); 3) Při úspěchu: s {id: , title, dueDate}; 4) Při neplatnosti: s {error: 'VALIDATION', details: array}; 5) Žádná databáze; in-memory ; 6) Zahrňte testovací soubor pokrývající platné, neplatné (prázdný název, datum v minulosti); 7) Poskytněte skripty pro test a vývoj; 8) Použijte ; 9) Nezahrnujte zbytečné komentáře.“
Všimněte si struktury: verze jazyka, knihovny, omezení, výstupy, chyby, testy a dokonce i struktura balíčku. Odstranili jste nejednoznačnost. Úkolem je vyplnit kód, nikoli požadavky.
Systém: Píšete . Vypisujte pouze bloky kódu s názvy souborů.
Chcete-li od přesnou generaci kódu, musíte mu dát rozjezdovou dráhu:
- Rámec systému (krátké vodítko)
- Vy: „Píšete produkční pro . Vypisujte pouze bloky kódu s názvy souborů a nic jiného.“
- Proč: Ovládáte tón a formát výstupu. Nenechávejte to náhodě.
- Zahrňte verze jazyka, výběr balíčků, sémantiku chyb, formáty I/O, limity výkonu a bezpečnostní omezení.
- Řekněte , ať nejprve napíše unit testy. Testy definují „přesné“ lépe než přídavná jména. Pokud řádek kódu neslouží testu, je to dekorativní prvek.
- Implementujte komponentu .
- „Pokud testy selžou nebo se neshodují importy, aktualizujte pouze selhávající části. Nepřepisujte celý projekt.“
funguje dobře, když má kontext a mantinely. Dejte mu mantinely.
Připnutí verzí není volitelné
Trénovací data jsou plná starých a nových dokumentů. To je slušný způsob, jak říct, že viděl spoustu protichůdných rad. „Použijte “ je vágní. „Použijte s datovými routery“ je instrukce. Nevěřte výchozím hodnotám:
- Jazyky: připněte na , , , – cokoli, co skutečně používáte.
- Frameworky: zadejte přesné hlavní verze a všechny příznaky způsobující zásadní změny.
- : připněte verze; vs má význam.
- Lintery/formátovače: zadejte pravidla, abyste se vyhnuli přepisování ve stylu „style ping-pong“.
Pokud nepřipnete, dostanete největší hity z pěti let starých blogových příspěvků. Přesná generace kódu je alergická na nostalgii.
Nejprve schéma, vždy
Nežádejte o struktury „uživatelského profilu“. Definujte schémata v podnětu a vyžadujte validaci:
Poté nechte vynutit schémata na hranicích – vstupy , zápisy do databáze a message queues. Požádejte o explicitní chybové payloady a kódy. Přesnost miluje schémata. Nejednoznačnost ne.
Udělejte to pozorovatelné, jinak nepředstírejte, že je to skutečné
Řekněte , ať přidá logování, metriky a trasy tam, kde je potřebujete – a ať je udržuje v klidu tam, kde je nepotřebujete. Dobrý podnět zahrnuje:
- Zásady logování: úrovně, redakce , struktura ( logy, prosím)
- Metriky: čas na požadavek, počty chyb
- Health endpointy: , které dokazují, že závislosti fungují
přidá to, o co požádáte. Pokud se nezeptáte, dostanete příkazy print – pokud budete mít štěstí.
Podněty „nejprve test“ jsou lepší než „jen mi věř“
Dobrý způsob, jak zadávat podněty pro přesnou generaci kódu, je udělat z testů zdroj pravdy. Příklad:
„Napište testy pro funkci , která:
- převede lokální a doménové části na malá písmena;
- odstraní tečky v lokální části pouze pro gmail.com;
- odstraní subadresy (+tag) pouze pro gmail.com;
- odmítne vstupy bez jediného @ nebo s mezerami;
- zachová unicode doménové punycode tak, jak jsou.
Pokryjte okrajové případy. Po napsání testů implementujte funkci tak, aby jimi prošla.“
často napíše lepší kód, když je nucen splnit testy, které jste popsali. Pokud se mu to nepodaří, máte konkrétní selhání, nikoli argument založený na pocitech.
Žádné halucinace konstrukcí
Nemůžete eliminovat halucinace, ale můžete je ohradit:
- Žádejte citace nebo zdrojové adresy pouze tehdy, když zdroje existují. U metod vyžadujte odkazy na dokumenty a vyžadujte, aby kód odpovídal těmto dokumentům.
- U soukromých vložte specifikaci do podnětu. Neočekávejte, že zná vaše interní endpointy.
- U knihoven s matoucími zahrňte ukázkový fragment z oficiálních dokumentů a řekněte , ať se jím řídí.
Přesný kód je většinou přesné odkazy. Dejte odkazy.
Průvodci stylem: Nejméně sexy, nejužitečnější věc
píše kód ve stylu, který odvodí. To je recept na změny. Vložte svého průvodce stylem. Zadejte:
- Formátování (, , výchozí )
Také vyžadujte krátký komentář s odůvodněním pro ne zcela zřejmé volby. Budoucí vy vám poděkuje a současný vytvoří méně s „opravami“.
Dlouhé podněty, krátké výstupy
Další způsob, jak přemýšlet o tom, jak zadávat podněty pro přesnou generaci kódu: utrácejte svá slova za podnět, nikoli za výstup. Chcete:
- Vyčerpávající omezení v podnětu
- Minimální množství cizích vyprávění ve výstupu
Řekněte mu, ať potlačí vysvětlení a vrací pouze bloky kódu s názvy souborů a krátký . Chcete-li komentáře, požádejte o ně v samostatném spuštění. Prolínání textu a kódu je způsob, jak se do kódu vkrádají chyby s monoklem a cylindrem.
Chcete-li kouzelnictví, jděte na kouzelnickou show. Chcete-li software, který se kompiluje a chová, pište podněty, které fungují jako záruky. Jak zadávat podněty pro přesnou generaci kódu není o květnatých frázích nebo tajných klíčových slovech. Je to o omezeních, testech, verzích a smyčkách zpětné vazby. Udělejte tyto čtyři věci a získáte kód, který běží. Přeskočte je a získáte krásně formátovanou fikci.
Nejrychlejší cesta ke spolehlivému kódu není „dostat to napoprvé správně“. Jsou to krátké, opravné smyčky:
- Spusťte lokálně. Vložte výstup neúspěšného testu a chyby kompilátoru zpět do doslovně.
- Instruujte: „Upravte pouze minimální nezbytné řádky; neměňte podpisy funkcí, pokud to nevyžadují neúspěšné testy.“
- Opakujte, dokud se nezobrazí zelená.
je vynikající v aplikaci diffů, když mu přesně řeknete, co se pokazilo. Nepřeformulujte protokoly selhání. Vložte je. Protokoly jsou pravda.
Zabezpečení je funkce, nikoli doslov
Protože jsou modely trénovány na veřejném kódu (dobrém, špatném i prokletém), chcete, aby bylo zabezpečení prvořadým požadavkem:
- Explicitně zakažte , a řetězcově typované
- Vyžadujte parametrizované dotazy, ochranu a omezení rychlosti
- Požádejte o připnutí závislostí plus lockfile
- Vyžadujte zpracování tajných klíčů prostřednictvím proměnných prostředí nebo správce tajných klíčů
Podnět, který je ve výchozím nastavení bezpečný, vede k bezpečnějšímu kódu. Podnět „opravíme to později“ vede k titulkům.
Výkon: Řekněte, co znamená „rychle“
„Udělej to rychle“ se překládá jako „dělej, co chceš“. Místo toho zadejte metriky:
- Cíle latence ( pro in-memory, pro operace)
- Časová složitost (musí být , nikoli )
si vybere algoritmy, které odpovídají rozpočtu, který nastavíte. Dejte mu rozpočet.
Dokumentace: Dostačující k zaučení cizince
Požádejte o , který zahrnuje:
- Pokyny k nastavení s přesnými verzemi
- Příkazy pro test, lint, typecheck, run
- Ukázkové požadavky/odpovědi
- Omezení a známé kompromisy
„Přesný kód“ zahrnuje přesnou dokumentaci. Jsou součástí dodávky.
Konkrétní šablony podnětů, které můžete ukrást
Šablona: Backend Endpoint
Systém: Jste pečlivý inženýr . Vypisujte pouze bloky kódu s názvy souborů.
Uživatel:
- Vytvořte aplikaci s endpointem .
- Požadavek: {amount: jako řetězec, from: 'USD'|'EUR', to: stejné}.
- Validujte pomocí ; vraťte tvar při chybách schématu.
- Použijte čistou funkci s pevnými sazbami {USD:1, EUR:1.1}.
- Vraťte {amount: řetězec, currency: řetězec} s .
- Zahrňte testy pokrývající platné, neplatné (špatné desetinné číslo, neznámý kód) a okrajové (0).
- Poskytněte s připnutými závislostmi; zahrňte konfigurace a .
- Žádné síťové hovory, žádné komentáře.
Šablona: CLI Utility
Uživatel:
- Vytvořte s názvem , který čte stdin a vypisuje -safe slugy.
- Pravidla: malá písmena, pouze , oddělovače spojovníky, sbalení mezer, odstranění interpunkce.
- Poskytněte a s tabulkovými testy.
- Zahrňte s testovacími a buildovacími cíli.
Šablona: Frontend Component
Systém: Jste pragmatický inženýr cílený na .
Uživatel:
- Props: value: řetězec, onChange(value): void, delay=300.
- Použijte ; žádné hooky třetích stran.
- Zahrňte testy s fake timery.
- Poskytněte minimální story.
Tyto šablony demonstrují, jak zadávat podněty pro přesnou generaci kódu připnutím verzí, definováním chování a vyžadováním testů.
Odmítání chytrosti: Kdy říct „Neoptimalizujte“
Pokud nechcete předčasné mikro-optimalizace (a nechcete), řekněte to:
- „Preferujte čitelnost před chytrostí; žádné bitové operace, pokud to testy nevyžadují.“
- „Žádná rekurze, pokud je iterativní kód jasnější.“
- „Žádné metaprogramování; explicitní > implicitní.“
rád ohromuje. Nenechte ho. Nechte ho projít testy a být čitelný. To je dostatečně působivé.
v pracovním postupu, kde skutečně pomáhá Viděl jsem lidi žonglovat s podněty v náhodných chatovacích oknech, jako by to byl produktivní rituál. Použijte pracovní prostor, který rozumí kontextu kódu. je například postaven tak, aby udržoval vaši specifikaci, kód, diffy a testovací protokoly na očích, takže smyčka „vlož chybu, oprav řádek“ je skutečně úzká. Není to magie; je to nudné lešení, které vám brání ztratit se v ději. Pokud váš nástroj udržuje smlouvu, testy a kód ve stejné konverzaci – aniž by vás otravoval konfetami – používejte ho. to dělá. Jak ladit s jako s kolegou, ne jako s věštcem
- Vložte výstup neúspěšného testu přesně tak, jak je. Neshrnujte.
- Požádejte o diff: „Odpovězte s unified diff proti souboru X pouze.“
- U chyb runtime přidejte nejmenší reprodukovatelný fragment a vyžádejte si vysvětlení plus patch.
- U chyb knihovny vložte výňatek z dokumentu, o kterém si myslíte, že platí, a zeptejte se: „Je to správné pro verzi X? Pokud ne, aktualizujte kód a uveďte správný výňatek.“
Cílem je, aby se hádal s důkazy. Vy přinášíte důkazy.
Přehlídka úskalí (a jak se jim vyhnout)
- Past „nejnovějšího“ : Neříkejte „použijte nejnovější“. Řekněte „použijte verzi X.Y“ a držte se jí.
- Prázdný testovací soubor: Pokud nebudete vyžadovat testy, nedostanete je.
- Klam jednorázového pokusu: Naplánujte si dvě nebo tři krátká vylepšení. Je to rychlejší než jeden nafouklý podnět.
- Nejednoznačné zásady pro chyby: Definujte stavové kódy a payloady. „Vraťte chybu“ neznamená nic.
- Neovládaná závislost: Pokud kód spoléhá na službu, kterou nemůžete ovládat, zastupte ji. Požádejte o fakes.
Kontrolní seznam pro vaše podněty (přilepte si ho k monitoru)
- Verze jazyka a runtime připnutá
- Sémantika chyb definována (kódy, tvary)
- Bezpečnostní omezení explicitní
- Stanoveny rozpočty na výkon
- Specifikován styl a struktura
- Omezen formát výstupu (názvy souborů, bloky kódu, diffy)
- Krátká smyčka vylepšení s vloženými protokoly
Pokud splníte všech deset, obecně produkuje přesnou generaci kódu, která přežije denní světlo.
Propracovaný příklad: Od vágnosti k ověření
Vágní podnět: „Napište funkci pro bezpečné parsování .“
Výsledek: Pravděpodobně v pořádku, možná špatně, určitě netestováno.
Přesný podnět:
„Píšete . Vypisujte pouze bloky kódu s názvy souborů.
Vytvořte a s funkcí . Požadavky: použijte s a ; zakažte nulové bajty; odmítněte soubory >10MB; omezte sloupce na 100; odstraňte ; zacházejte s prázdnými buňkami jako s prázdnými řetězci; vyvolejte se zprávou kódy {FILE_TOO_LARGE, NULL_BYTE, TOO_MANY_COLUMNS}. Zahrňte testy v s pokrývající happy path, nulový bajt, 11MB soubor, 101 sloupců a zpracování . Poskytněte s připnutými závislostmi a konfiguraci .“
Získáte kód, testy a zpracování okrajových případů. Poté spustíte testy, vložíte selhání a iterujete s minimálními diffy. To je v praxi přesná generace kódu.
O „kreativitě“ a dalších marketingových slovech
Nepotřebuji „kreativní“ kód. Potřebuji správný kód. Ušetřete kreativitu na pojmenování své kočky. Při zadávání podnětů je kreativita přirozeným vedlejším produktem pevných omezení. Správné testy a jasné specifikace produkují elegantní řešení. Špatný podnět produkuje „převynalezený s emoji“. Nepokoušejte ho.
Netajné tajemství
Způsob, jak zadávat podněty pro přesnou generaci kódu, je nudný: zapište si, co potřebujete, připněte verze, definujte schémata, vyžadujte testy a iterujte se skutečnými selháními. To je vše. Žádný mysticismus. Jen inženýrská disciplína s modelem, který dokáže velmi rychle psát a nevadí mu psát patnáct téměř identických testovacích případů.
A to je ten zvrat: přesnost je neokázalá. Podněty, které fungují, zní jako kontrolní seznam . Kód, který se odesílá, vypadá, jako by ho napsal člověk, kterému na tom záleželo. Obojí získáte tak, že se k modelu chováte jako k mladšímu inženýrovi, kterému se daří při jasných požadavcích a vadne při vágním vedení. Dejte mu smlouvu. Nechte ho projít testy. Pak mu možná můžete věřit – s takovou důvěrou, jakou dáváte nástroji, ne prorokovi.
Závěr: Méně kouzelnictví, více záruky
Kódu je jedno, jaké máš pocity. Naštěstí testům taky.
FAQ
Otázka 1: Jaký je nejjednodušší způsob, jak Claude Haiku 4.5 vyzvat k přesné generaci kódu?
Přistupujte k němu jako ke smlouvě: pevně stanovte verze, definujte schémata, specifikujte formáty chyb a vyžadujte nejprve testy. Čím jasnější jsou omezení, tím přesnější bude kód.
Otázka 2: Jak snížím halucinace, když Claude píše kód?
Vložte autoritativní dokumentaci nebo specifikace a vyžadujte dodržování přesně těchto API. Pro soukromé koncové body (endpointy) zahrňte vlastní specifikaci – neočekávejte, že bude hádat.
Otázka 3: Mám požádat Claude o testy, nebo je mám psát sám?
Nejprve požádejte Claude, aby generoval testy, a poté implementujte kód, který je uspokojí. Testy definují přesnost lépe než adjektiva a udržují model čestný.
Otázka 4: Jak konkrétní by mělo být pevné stanovení verzí (version pinning) ve výzvách?
Velmi konkrétní: běhové prostředí jazyka, hlavní/vedlejší verze frameworku a verze SDK. „Nejnovější“ vybízí ke konfliktním vzorům; přesnost závisí na stabilních cílech.
Otázka 5: Jak zapadá Sider.AI do výzev pro přesný kód?
Používejte Sider.AI k uchování specifikací, kódu, rozdílů (diffs) a protokolů testů v jednom cyklu. Nedělá to zázraky – pouze uchovává kontext, takže opravy od Claude sledují vaše skutečné chyby. 
