Блог

Claude неге қажет емес нәрсе жасайды: 3 сұрау мәтіні

Markdown

Claude сіздің ниетіңізді түсінбей, бірден код жазуға кіріскендіктен, қажет емес нәрсе жасайды. Мұның себебін түсіндіріп, алдымен сұрақ қоюға көмектесетін дайын 3 сұрау мәтінін ұсынамын.

Мақаланы толық оқу

Негізгі түйін

Claude бірден код жазуға кірісіп, сіз не қаладыңыз деп өзі ойлағанын қосқандықтан, қажет емес нәрсе жасайды. Көбіне оның жорамалы қате болады. Мәселе дерлік ешқашан модельде емес: тіпті ең мықты модель де бұлыңғыр тапсырманың мәнін түсінбей қалуы мүмкін. Мен мұны бір тәсілмен шешемін: Claude-тен алдымен менімен сұхбаттасып, ниетімді анықтауын, содан кейін ғана жазуын сұраймын. Төменде көшіріп, қоя салуға болатын үш дайын сұрау мәтіні берілген.

Қызметті пайдалану туралы толығырақ Ailoot құжаттамасынан оқыңыз.

Claude неге қажет емес нәрсе жасайды?

Негізгі түйін

Claude қысқа сұрау алады да, жетіспейтін тұстарды бірден өзі толықтырып, тапсырманы өзінше түсініп код жазуға кіріседі. Оның түсінігі сіздікінен өзгеше. Сөйтіп, сіз бір жолдық өзгеріс күтсеңіз, 14 файлға тиетін diff аласыз. Мұның себебі — айтқаныңыз бен ойыңыздағының арасындағы алшақтық. Модельдің бұған дерлік қатысы жоқ.

Сіз: «Өнімдер бетіне сүзгілер қос» деп жазасыз. Ойыңызда бірнеше құсбелгі мен жаңартылған тізім бар. Claude де осыны көріп, өзіндік күй қоймасы, бөлек енгізу кідірісінің логикасы, URL синхрондауы және он шақты көмекші функциясы бар толыққанды сүзгілеу жүйесін құруға кіріседі. Ал бірнеше URL параметрі жеткілікті болар еді; оның орнына жүздеген жол код жазылады.

Мұндай жағдайда қорытынды анық: агент қате жіберген жоқ; ол қажеттіден әлдеқайда үлкен мәселені шешті. Кінә қалаған нәтиженің қысқаша әрі нақты сипатталмауында еді.

Мұндағы басты сөз — «ниет». Ол сіздің ойыңызда бар, Claude-де жоқ. Ол сұрауыңыздың мәтінін және сол сұрауға дейінгі контекстің бәрін көреді. Содан кейін ол олқылықтарды жорамалмен толтырады. Сұрау неғұрлым қысқа болса, жорамал соғұрлым көп болады, ал нәтиже қалағаныңыздан соғұрлым алшақтайды.

Anthropic мұны Claude Code құжаттамасында ашық айтады:

Claude-ті бірден код жазуға жіберсеңіз, ол қате мәселені шешуі мүмкін.

— Claude Code Docs, https://code.claude.com/docs/en/best-practices

Мен мұны өз жобамда бастан өткердім. Бір авторизация экранын жөндеуді сұрап едім, көршілес модульдің жартысына әсер ететін diff алдым. Claude кінәлі емес: мен оған бір жол жаздым, ал қалғанын өзі толықтырды. Содан бері қате түзетуден үлкен кез келген тапсырманы сұрақтардан бастаймын — оларды Claude маған қояды.

Мәселе шынымен модельде ме, ең мықты модельдер де неге мүлт кетеді?

Негізгі түйін

Модель адамдар ойлағаннан азырақ маңызды. Тапсырма бұлыңғыр болса, тіпті ең мықты модель де мүлт кетеді: оған да толық емес нұсқаулар беріледі, ал ол олқылықтарды өз жорамалдарымен толтырады. Агентін бақылауда ұстайтын әзірлеушілер үздік модельді де, орта деңгейлі модельді де қолданса, бірдей нәтижеге жетеді. Барлығы қалағаныңызды қаншалықты анық сипаттайтыныңызға байланысты. Мұнда модель қуаты екінші орында.

Әр апта сайын алдыңғысынан «ақылдырақ» модель шығады. Әр жолы AI ақыры бірнеше сөзден бізді түсінетін сәт келді деп ойлаймыз. Бірақ олай болмайды. Қуатты модель кодты жылдамырақ жазады және күрделі логиканы жақсырақ орындайды, бірақ ол да ойыңызды оқи алмайды. Тапсырма дұрыс тұжырымдалмаса, әдемі жазылғанымен, бәрібір қате нәтиже аласыз.

Сізге арналған түйін қарапайым. Жаңа модель жақсырақ жорамалдайды деп соңғы үлгіні қуа беру — тығырық. Оған жорамал жасаудың қажеті болмайтындай тапсырма беруді үйрену арзанырақ әрі сенімдірек. Енді соған көшейік.

Гриллинг деген не және ол AI-мен түсініспеушілікті қалай жояды?

Негізгі түйін

Гриллинг — AI жұмысқа кіріспей тұрып, сізден сұхбат алып, ортақ түсінікке жеткенше тапсырма туралы егжей-тегжейлі сұрақтар қоюы. Мақсат — алғашқы код жолы жазылмай тұрып, қарым-қатынастағы алшақтықты жою.

Бұл қисынға қайшы сияқты. Жұмысты жылдам бітіру үшін AI-ға жүгінеміз, ал енді оны баяулатып, алдымен сұрақ қоюға мәжбүрлеу керек дейді. Бірақ кодтауға дейінгі бес минуттық сұрақтар кейінгі бір сағаттық түзетуден құтқаруы мүмкін.

Мәселе тек Claude-ке нашар түсіндіргеніңізде емес. Көбіне тапсырманы өзіңіз де толық ойластырып үлгермеген боласыз: қандай жағдайларды ескеру керек, шекаралары қайда, ең маңыздысы не. Гриллинг сұрақтар арқылы осыны анықтауға көмектеседі. Әңгіме соңында AI түсінетін тапсырма ғана емес, өзіңіз де ақыры егжей-тегжейлі тұжырымдаған тапсырма дайын болады.

Контекст инженериясы осылай жұмыс істейді: негізгі жұмыс сұрау мәтінін жазғанда емес, оған дейін атқарылады. Сіз сиқырлы сөз тіркесін іздемейсіз; Claude артық түсіндірусіз ұғуы үшін оған қажет нәрсені алдын ала тәптіштейсіз.

Claude-тен алдымен сұрақ қоюын қалай сұрайсыз?

Негізгі түйін

Claude-ке тапсырманы қысқаша сипаттап, жұмысқа кіріспей тұрып сізден сұхбат алуды анық айтыңыз: егжей-тегжейлер, шеткі жағдайлар және шектеулер туралы сұрасын, соңында бәрін спецификация файлына жинақтасын. Бұл — Anthropic-тің ресми ұсынысы; Claude Code құжаттамасында дайын сұрау үлгісі бар. Оны көшіріп, сипаттамасын өзгертіп, сессияның басында қойыңыз.

Anthropic бұл тәсілге рұқсат беріп қана қоймай, оны ұсынады. Құжаттамасында «Claude-тен сізбен сұхбат алуын сұраңыз» деген бөлім және дайын сұрау мәтіні бар. Міне, қолдануға ыңғайлы нұсқасы:

Сұрау мәтініГриллингке арналған сұрау мәтіні — Claude сізден сұхбат алсын

Мен [тапсырманың қысқаша сипаттамасын] құрастырғым келеді.

Код жазбай тұрып, менімен егжей-тегжейлі сұхбаттасыңыз. Іске асыру, интерфейс, шеткі жағдайлар, тәуекелдер және ымыралар туралы сұраңыз. Айқын сұрақтар қоймай, мен ой елегінен өткізбеген күрделі тұстарды анықтаңыз.

Бір уақытта бір сұрақ қойып, жауабымды күтіңіз. Әр сұрақ бойынша бірден ұсынатын жауабыңызды айтыңыз.

Барлығын қамтығанша жалғастырыңыз. Содан кейін толық спецификацияны SPEC.md деп аталатын файлға жинақтаңыз.

Бұл сұрау мәтінін сән үшін емес, пайдалы ететін үш жайт бар. Біріншісі — «бір уақытта бір сұрақ». AI бірден он сұрақты үйіп-төксе, абдырап, үстірт жауап бересіз. Екіншісі — «жауабыңызды ұсыныңыз»: бәрін нөлден ойлап табудың қажеті жоқ, ұсынысқа келісуге немесе оны түзетуге болады. Үшіншісі — «спецификацияны файлға жинақтаңыз»: анықталған ниет құжатқа айналып, жоғалмайды.

Anthropic бұл тәсілдің пайдасын жұмсалған уақытпен түсіндіреді:

Спецификацияны дұрыс жасауға кеткен уақыт іске асыруды бақылауға кеткен уақыттан пайдалырақ.

— Claude Code құжаттамасы, https://code.claude.com/docs/en/best-practices

Сұхбаттан кейін жаңа сессия ашып, дайын спецификацияны беріңіз. Таза контекст, анық баяндалған ниет — сонда Claude алғашқы әрекеттен-ақ көздегеніңізге жетеді.

«Бұл ең жақсы жоспар екенін маған дәлелде» тәсілі

Негізгі түйін

AI-дан сұрақ қоюды ғана емес, шешімін қорғауды да талап етіңіз. Мен тапсырмаға ұсынылған жоспардың ойға бірінші келген нұсқа ғана емес, ең жақсысы екенін және бірнеше қадам алға ойластырылғанын дәлелдеу талабын қосамын. Сонда Claude «соған ұқсас бірдеңе істей саламын» деген күйден сыншы күйіне ауысады да, іске асыруға уақыт жұмсамай тұрып жұмысын тексереді.

Гриллинг ниетіңізді анықтайды. Бірақ AI-дың тағы бір әдеті бар: нанымды көрінетін алғашқы шешімді таңдау. Anthropic мұны «сен, бірақ тексер» алшақтығы деп атайды: Claude нанымды іске асыру нұсқасын ұсынады, бірақ ол шеткі жағдайларда сыр береді. Шешімі — кодқа дейін дәлел талап ету.

Нәтижені тексере алмасаңыз, оны ұсынбаңыз.

— Anthropic, Claude Code Docs, https://code.claude.com/docs/en/best-practices

Сұрау мәтініме дерлік әрдайым «дәлелде» бөлімін қосамын. Нақты мәтіні:

Мәтін — AI-дан жоспарын қорғауды сұрауға арналған нұсқау

Код жазбай тұрып, тапсырманы сын көзбен талдаңыз.

Оны шешудің 2-3 жолын табыңыз. Әрқайсысы күрделілікті орынсыз қоспай, тапсырмамды шынымен шешетінін дәлелдеңіз. Кодты тек код жазу үшін жаза салмаңыз.

Содан кейін бір нұсқаны таңдап, оның бірнеше қадам алға ойластырылған ең жақсы шешім екенін дәлелдеңіз. Жоба өскенде не бұзылады? Қазір нені ескермей отырмыз?

Осыдан кейін ғана іске асыру нұсқасын ұсыныңыз.

Бұл бөлім болмаса, Claude іске жарамды көрінген алғашқы нұсқаны береді. Оны қоссаңыз, Claude тығырыққа тірейтін нұсқаларды өзі алып тастап, таңдауын түсіндіреді және бір файлға да тимей тұрып, пайымын көруге мүмкіндік береді. Код күткендей жұмыс істемейтінін анықтауға бір сағат жұмсағанша, екі минутта оқылатын қысқа мәтінді қарап шығасыз.

Алдын ала өкіну талдауы: бастамай тұрып AI-дан сәтсіздіктің 10 себебін тапқызу

Негізгі түйін

Алдын ала өкіну талдауы — AI-дан жоба сәтсіз аяқталып қойғандай елестетіп, оның себептерін атауды сұрайтын тәсіл. Claude оптимистік «бәрін бітіріп тастаймын» күйінен шығып, бір апта жұмыс істегеннен кейін ғана байқалатын осал тұстарды іздей бастайды. Жобаға уақыт жұмсамай тұрып тәуекелдер тізімін алып, оларды алдын ала шеше аласыз.

Бұл — менің сүйікті тәсілім, әрі оның негізі психологияда. AI-дан «жақсы жұмыс істеуді» сұрасаңыз, ол сәтті нәтижеге бейімделіп, олқылықтарды байқамай өтуі мүмкін. Ал сәтсіздікті елестетуді сұрасаңыз, бұрын елемеген нәрселерін көре бастайды. Сұрау қысқа:

Сұрау мәтініАлдын ала өкіну талдауына арналған сұрау — бастамай тұрып олқылықтарды табу

Бір жылдан кейінгі уақытты елестетіңіз. Біз жоспарлап отырған жоба сәтсіз аяқталды.

Бұған не себеп болғанын көрсететін 10 себепті жазыңыз. Бастапқыда нені ескермедік, нені жеткілікті бағаламадық, қай тұста сападан қысқарттық және қандай болжамдар жалған болып шықты?

Содан кейін әр себеп бойынша оның алдын алу үшін дәл қазір нені түзете алатынымызды айтыңыз.

Жоспарды мақұлдамас бұрын осы сұрауды қолданамын. Себептердің жартысы бос сөз болып шығады, ал қалған жартысы — бір аптадан кейін тап болатын нақты тұзақтар. Оларды жоспарлау кезеңінде шешуге он минут кетеді. Ал дайын жобада соларға тап болып, зерттеуге бірнеше күн жұмсайсыз.

Үшеуін бірге қолдану оңай: гриллинг ниетті анықтайды, «дәлелде» шешімді қорғайды, ал алдын ала өкіну талдауы олқылықтарды табады. Код жазуға кіріспей тұрып қоятын үш қысқа мәтін. Олар Claude-ті асығыс орындаушыдан алдымен ойланатын серіктеске айналдырады.

Контекст шамадан тыс жүктелсе, Claude неге ақымақ болып көрінеді?

Негізгі түйін

Claude-тің контекст терезесі шектеулі: ол бір сәтте есте ұстай алатын ақпарат көлемі. Терезе жартысынан артық толғанда, Claude маңызды егжей-тегжейлерді жоғалтып, бұрынғы келісімдерді шатастыра бастайды және оларды еске түсірудің орнына олқылықтарды өзі толтырады. Бір күн бұрын келіскен нәрседен күн соңында мүлде басқа нәтиже шығуының жиі себебі — әр нәрсе талқыланатын ұзақ сессия.

Тапсырма мінсіз тұжырымдалса да, ретсіз контексте жұмыс істесеңіз, бәрі бұзылады. Механизмі мынадай: әр жаңа сұрауыңызбен бірге бүкіл чат тарихы Claude-тің жұмыс контексіне қосылады. Сессия ұзарған сайын терезе жылдамырақ толады. Оны жартысынан асырмаңыз; одан кейін AI ақымақ болып, әңгіменің басындағы маңызды нәрселерді жоғалта бастайды.

Маған ең көп көмектесетін ереже мынау: бір тапсырма — бір чат. Функцияны аяқтадыңыз ба? Чатты жауып, келесі тапсырмаға жаңасын ашыңыз. Иә, бәрін бір терезеде істеу кейде ыңғайлырақ, бірақ контекст жоғалып, жауаптар тақырыптан ауытқиды.

Anthropic бұл сәтсіздік түрін «қоқыс жәшігіндегі сессия» деп атайды. Шешімі қарапайым: бір-біріне қатысы жоқ тапсырмалардың арасында /clear қолданып, терезені тазалаңыз. Сонда алдыңғы тапсырманың ретсіздігі жаңасына көшпейді.

Ұзақ сессиялар жүргізіп, ақша мен AI назары қайда кетіп жатқанын түсінбесеңіз, бұл туралы Claude Code токендері қайда кететінін түсіндіретін нұсқаулықта бөлек жаздым. Ал Claude әр іске қосылған сайын оқитын тұрақты контекст негіздерін CLAUDE.md баптау нұсқаулығында жинақтадым.

Гриллинг пен Plan Mode-тың айырмасы неде және оларды қалай бірге қолдануға болады?

Негізгі түйін

Гриллинг пен Plan Mode бір мәселенің екі бөлек бөлігін шешеді. Жоспар әлі жоқ кезде гриллинг сұрақтар арқылы ниетіңізді анықтайды. Plan Mode түсінікті болып қойған тапсырма бойынша өзгерістер жоспарын көрсетеді де, сіз мақұлдағанша ештеңеге тимейді. Екеуін бірге қолданған тиімді: алдымен гриллинг не құрастыратынымызды нақтылайды, содан кейін Plan Mode қалай жасалатынын көрсетеді.

Адамдар бұл екі тәсілді жиі шатастырады немесе біреуі ғана керек деп ойлайды. Іс жүзінде олар үдерістің әр кезеңіне жатады.

МүмкіндікГриллингPlan Mode
Қай кездеЖоспарға дейін — ниетті нақтылайдыОдан кейін — өзгерістер жоспарын жасайды
Кім кімнен сұрайдыAI сізден сұхбат аладыСіз жоспарды оқып, мақұлдайсыз
НәтижесіТапсырма спецификациясыФайлдар бойынша өзгерістер жоспары
Негізгі пайдасы«Мен мұны қалаған жоқ едім» жағдайының алдын алады«Басқа ештеңеге тиме» жағдайының алдын алады

Anthropic төрт кезеңнен тұратын қалыпты жұмыс тәртібін сипаттайды: алдымен Explore (Claude зерттеп, сұрақтар қояды), содан кейін Plan (өзгеріс енгізбей жоспар құрады), одан соң Implement (жоспарға сай код жазады), соңында Commit (нәтижені тіркейді). Гриллинг бірінші кезеңде, Plan Mode екіншісінде қолданылады. Екінші кезең туралы толық мәліметті Claude Code ішіндегі Plan Mode нұсқаулығынан қараңыз.

Anthropic-тің маңызды ескертуі бар: шағын тапсырмаларға мұны жүктемеңіз.

Өзгерісті бір сөйлеммен сипаттай алсаңыз, жоспарды өткізіп жіберіңіз.

— Claude Code ресми құжаттамасы, https://code.claude.com/docs/en/best-practices

Қате түзету, атауды өзгерту немесе бір жолдық өзгеріс болса, сұхбатсыз және жоспарсыз, бірден жазыңыз. Гриллинг екіұшты әрі қателесу қымбатқа түсетін тапсырмаларда пайдалы. Ұсақ тапсырмаларда тек уақытыңызды алады.

AI-ға қажет емес нәрсе жасататын тапсырманы тұжырымдаудағы 5 қате

Негізгі түйін

AI-дың басым бөліктегі мүлт кетуі тапсырманы тұжырымдаудағы бес қатеден туындайды: бұлыңғыр бір жолдық өтініш, шектеулердің болмауы, «алдымен түсін» кезеңінсіз «код жаз» деу, «дайын» деген өлшемді анықтамау және бәрін бір шексіз сессияда жасау. Мұның әрқайсысы Claude-ті тапсырманы жорамалмен толықтыруға итермелейді. Төменде әр қатенің үлгісі мен оны қалай түзету керегі берілген.

Жиі кездесетін тұзақтарды кестеге жинақтадым. Сол жақта адамдар әдетте не істейтіні және нені қате жасайтыны, ал оң жақта оның орнына не істеу керек екені көрсетілген.

ҚатеҚалай естіледіОның орнына не істеу керек
Бұлыңғыр бір жолдық өтініш«Басқару панелін жақсарт»Тапсырманы сипаттап, гриллинг сессиясын бастаңыз — AI сұрақтар арқылы егжей-тегжейін анықтасын
Шектеулер жоқ«Авторизация қос»Ненің бұзылмауы керек екенін, қандай кітапханаларды қоспау керегін және қайсысы ауқымнан тыс екенін айтыңыз
Бірден «код жаз» деуСұрау — код жаза бастауАлдымен «түсініп, сұрақ қой», содан кейін код жаз
«Дайын» деген өлшем жоқAI нәтижені өзі болжайды деп күтесіз«Жұмыс істейді» дегеннің мәнін көрсететін мысал, анықтамалық скриншот немесе тест беріңіз
Бәріне бір сессияКүні бойы бір чатта отыруКонтекст ретсіз болмауы үшін бір тапсырмаға бір жаңа чат ашыңыз

AI қате жауап берген соңғы сұрауды қарап шығыңыз. Әрине, осы бес қатенің бірі болған шығар. Ең жиі кездесетіні — біріншісі: қысқа тіркес жазып, қалғанын Claude дұрыс толықтырады деп күттіңіз. Қалғанын ол толықтырды — тек сіз ойлағандай емес.

Енді не істеу керек: AI сізді бірнеше сөзден түсінетін жүйе құрыңыз

Негізгі түйін

Жеке сұрау мәтіндері жеке тапсырмаларды шешеді. AI ұзақ түсіндіруді қажет етпей түсінуі үшін жүйе керек: гриллинг әр тапсырманың ниетін анықтайды, Second Brain жоба туралы білімді сақтайды, ал контекст инженериясы Claude сұрау мәтінінен бұрын оқитын ақпараттың бәрін байланыстырады. Сонда қажет емес нәрсе жасауына себеп қалмайды: жорамал жасамас үшін оған әрдайым жеткілікті контекст болады.

Бұл нұсқаулықтағы үш сұрау мәтіні — гриллинг, «дәлелде» және алдын ала өкіну талдауы — нақты тапсырманы шешуге көмектеседі. Мұның өзі көп: бір жолдық өзгеріс керек болғанда, енді 14 файлдық diff алмайсыз.

Бірақ гриллингтің шегі бар. Әр жолы ниетіңізді нөлден анықтау көп уақыт алады. Нағыз өзгеріс контекстіңіздің бір бөлігі әрдайым қолжетімді болғанда басталады: жоба туралы білім сақталған қалтада, Claude әр іске қосылған сайын оқитын CLAUDE.md файлында және дағдыларға кодталған әдістемеңізде. Сонда AI тапсырмаға бизнесіңізді, мақсаттарыңыз бен мәнеріңізді біліп келеді — контекстің жартысын алдын ала түсіндіріп қойғандықтан, бірнеше сөзден-ақ түсінеді.

Anthropic-тің жуырдағы талдауы мұның қаншалықты үлкен жұмыс екенін көрсетеді: әзірлеушілер AI-ды жұмысының шамамен 60%-ында пайдаланады, бірақ тапсырмалардың тек 0-20%-ын ғана оған толық сеніп тапсыра алады. Қалғаны үшін сіздің түсінігіңіз, бақылауыңыз және нені құру керегін түсіндіре білуіңіз қажет. Ең ақылды модельді қуа бермей, дамытуға тұрарлық қабілет — осы.

Ailoot-пен танысыңыз.

Толығырақ

Жиі қойылатын сұрақтар

Бірден кодқа өтпей, сұхбат промптын қашан қолданамын?

Нәтиже, шеткі жағдайлар не шектеулер анық емес әрі қате қымбатқа түссе, оны қолданыңыз. Бір-бірден сұрақ қойып, келісілген нәтижені SPEC.md файлына сақтаңыз. Анық сипатталған бір жолдық өзгерісті не қатені тікелей сұрауға болады.

Ұсынылған жоспарды қабылдамас бұрын нені тексеремін?

Екі-үш тәсіл сұрап, әрқайсысының спецификация мен шектеулерге сәйкестігін салыстырыңыз. Кейін алдын ала сәтсіздік талдауының промптын орындап, аталған себептерді қараңыз және іске асырудан бұрын тиісті тәуекелдерді шешіңіз.

Барлық мақалалар