Міне, сіздер сұраған нәрсе келді! Ralph TUI, Ralph Loop-ты көрнекілендіру

Мен бұған дейін ralph-loop туралы оқулық жазған болатынмын, көптеген достар іске қосқаннан кейін бірдей пікір білдірді: Керемет, Claude Code ақыры ұзақ уақыт жұмыс істей алады. Бірақ кейде оның қозғалмай тұрғанын байқасаңыз, ішіңізден күдіктенесіз: "Ол ілгері жылжып жатыр ма, әлде бір орында айналып жүр ме?"

Бұл менің жақында ralph-tui-мен айналысуымның себебі.

ralph-tui Claude Code-қа міндетті түрде байланбайды, ол ralph loop-тың мәнін мұра етіп, дамытады, сонымен қатар тапсырмаларды орындау мен процесті көрнекілендіреді, бұл үлкен модельдің ұзақ уақыт жұмыс істеу шегін айтарлықтай төмендетеді. Сіз басқа агентті, басқа модельді, отандық, арзан, ұзақ уақыт істете алатын түрін қоса аласыз. Ralph-tui-мен біз үшін, қарапайым адамдар үшін, механикалық берілістен автоматты беріліске ауысқанмен бірдей, тіпті круиздік бақылауы да бар.

Бұл не нәрсе?

Сіз ralph-tui-ді "AI coding agent-тің циклдік реттеушісі" ретінде түсіне аласыз, бірақ ол "жұмыс істей алу"-мен шектелмейді, ол "сіз көре аласыз, басқара аласыз, қалпына келтіре аласыз" дегенге көбірек мән береді.

Оның негізгі жұмыс тәсілі өте қарапайым:

• Сіз оған бір топ тапсырма бересіз (PRD-дан да келуі мүмкін, басқа тапсырма жүйесінен де келуі мүмкін)
• Ол ең жоғары басымдықты таңдайды
• Prompt-ты құрастырады
• Агентті іске қосады
• Бұл тапсырманың орындалған-орындалмағанын анықтайды
• Күйін жазады
• Келесі айналымды жалғастырады

Ең бастысы: мұның бәрін терминалда көре аласыз, сонымен қатар кез келген уақытта тоқтатып, кез келген уақытта қабылдай аласыз. Ол өзінің позициясын да тікелей жазған: интерактивті TUI бар agent loop orchestrator, сонымен қатар TUI / headless / remote-ты қолдайды.

Неліктен оның "ұзақ уақыт жұмыс істеуге" көбірек жарамды екенін айтамын?

Скрипттің loop-ты іске қосуының ең үлкен мәселесі - оның іске қосылмауы емес, оның қай жерге жеткенін білмеуіңіз.

Журналдардың жылдам жаңарғанын, желдеткіштің де жақсы айналып тұрғанын көресіз, бірақ сіздің көңіліңіз толмайды:

• Ол бір қатені қайта-қайта түзетіп жатыр ма?
• Ол бір кодты қайта-қайта өзгертіп, содан кейін қайтадан өзгертіп жатыр ма?
• Ол аяқталды ма, бірақ шықпады ма?
• Ол қандай да бір тестте тұрып қалып, шексіз айналып жатыр ма?

ralph-tui-дің шешімі өте "инженерлік":

• Session ұғымы бар, күйі дискіге түседі (.ralph-tui/session.json)
• Құласа, қайтадан іске қосуға болады (crash recovery)
• Құлыптау механизмі бар, бірнеше дананы ашып, каталогты былғап тастамау үшін
• Тіпті headless-ті CI-ге тастап іске қосуға болады, тіпті remote-та listener ашып, жергілікті TUI-ді қосуға болады

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

Қалай орнатуға болады

ralph-tui бұл Bun/TypeScript экожүйесі, орнату өте оңай. Ресми орнату беті де берілген.

Алдымен сіздің машинаңызда bun бар екеніне көз жеткізіңіз:

bun --versionсодан кейін ralph-tui-ді орнатыңыз (мен мұнда типтік орнатуды беремін, нақтысы ресми орнату бетінде):

bun add -g ralph-tuiОрнатып болған соң тексеріп көріңіз:

ralph-tui --helpЕгер сіз Node жақтасы болсаңыз және bun-ға тигіңіз келмесе, онда былай істеуге болады:

npm i -g ralph-tui

Үлкен нәрселерді істемес бұрын, ең аз тұйықталған циклді іске қосыңыз

Мен бірінші рет қолданғанда, бірден "бүкіл repo-ны қайта құру" сияқты нәрселерді жасамауға кеңес беремін. Сіз бір нәрсені ғана жасаңыз: қабылдауға болатын шағын тапсырманы іске қосыңыз.

Инициализация

Кез келген каталогты ашыңыз:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupБұл интерактивті шебер процесіне өтеді, қарапайым тілмен айтқанда, "ralph-tui-ді осы қоймаға орнату", ол:

• Сіздің компьютеріңізде қандай агенттердің орнатылғанын автоматты түрде анықтайды (мысалы, Claude Code, OpenCode және т.б.)
• Жобада конфигурация файлын жасайды: .ralph-tui/config.toml
• PRD жасау/тапсырмаларды түрлендіруге қатысты дағдыларды орнатады (кейіннен өзіңіз қолмен жасаудың қажеті жоқ)

Менің жеке кеңесім: бірінші ретте жалқауланбаңыз, setup-ты бір рет іске қосыңыз.

Жоба PRD-ін жасау

Setup аяқталғаннан кейін, келесі қадам - ​​ресми оқулықтағы ең маңызды және блог демо-нұсқасы ретінде жазуға ең қолайлы бөлім: create-prd.

ralph-tui create-prd --chat бұл команда диалогтық процеске өтеді, ол сіздің сұраныс мақсаттарыңызды, шекаралық шарттарыңызды және қабылдау критерийлерін өнім менеджері сияқты сұрайды. Сұрағаннан кейін ол жобада тікелей екі нәрсені шығарады (бұл ең маңыздысы):

• PRD markdown файлы: ./tasks/prd-feature.md
• Тікелей орындалатын тапсырма файлы: ./prd.json

Осы қадамда сіз ralph-tui-дің "стандартты тұйық цикліне" шынымен кіресіз:

Сұраныс (PRD) → Тапсырма (prd.json) → Орындау (run)

Іске қосу

prd.json болғаннан кейін, run іске қосу қисынды:

ralph-tui run --prd ./prd.json сіз TUI-дің іске қосылғанын көресіз, цикл басталады: тапсырманы таңдау → орындау → аяқталғанын анықтау → күйді жазу → аяқтау немесе келесі айналым.

Бірінші рет іске қосқанда, мен итерация шегін қосуды ұсынамын, алдымен оны торға қамаңыз:

ralph-tui run --prd ./prd.json --iterations 5 іске қосқаннан кейін өзгерістерді қараңыз, тесттерді іске қосыңыз, PRD және тапсырманың күтілетіндей екенін қараңыз. Бұл тізбектің өтетініне көз жеткізіңіз, содан кейін итерацияларды босатыңыз, содан кейін бассыз/қашықтан іске қосыңыз, бұл сенімді ырғақ.

Осы кезде сіз негізінен растай аласыз: бұл цикл шынымен іске қосылды.

Модельді/Агентті қалай таңдауға болады? Ақшаны үнемдеу туралы шындықты айту керек

Көптеген адамдарды ең қызықтыратыны: "Мен Claude Code-ты пайдаланбасам бола ма? Арзан модельді пайдалануға бола ма?"

Жауап: болады.

ralph-tui сізге агент пен модельді көрсетуге мүмкіндік береді (ресми run құжаттамасында мысалдар бар).

Мысалы, Claude Opus-ты пайдалану:

ralph-tui run --prd ./prd.json --agent claude --model opus бірақ шынымды айтсам, мен "тесттерді толықтыру, lint-ті түзету" сияқты жұмыстарды Opus-пен жасамас едім, өте қымбат. Менің әдетім - қабаттау:

• Арзан модель: көптеген қайталанатын жұмыстарды орындау (тесттерді толықтыру, түсініктемелерді толықтыру, форматты түзету, шекараларды қосу)
• Қымбат модель: тек маңызды түйіндерде пайда болады (архитектураны реттеу, қиын қателер, негізгі логика)

Егер сіз қарапайым әзірлеуші ​​болсаңыз, бұл тәсіл одан да маңызды. Себебі сізде ірі компанияның бюджеті жоқ, шығындарды бақылауға алуыңыз керек, сонда сіз ұзақ уақыт жұмыс істей аласыз.

Одан да жақсырақ болғыңыз келе ме? "PRD жазуды" да агентке тапсырыңыз

ralph-tui-де маған ұнайтын дизайн бар: ол дағдыларды қолдайды (шындығында, бұл агенттің қосымша командалар жиынтығы).

Ресми орнату әдісі add-skill арқылы:

bunx add-skill subsy/ralph-tui --all немесе көрсетілген агентке орнатыңыз, мысалы, claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y орнатқаннан кейін, сіз агент сеансында қиғаш команданы пайдалана аласыз:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads бұл сіз IDE-ге плагин орнатқанға ұқсайды, бірақ бұл плагин агентке арналған. Оның мағынасы - "адамның сұранысты тасымалдау" уақытын қысқарту, сұраныстың → тапсырманың → орындаудың конвейерге ұқсауын қамтамасыз ету.

Оны қашан пайдалану керек? Қашан пайдаланбау керек?Маған "бәрін де AI арқылы шешуге болады" деген әңгіме ұнамайды, ол адамдарды жаңылыстыруы мүмкін. Құрал дегеніміз құрал, ол тек сәйкес жағдайда ғана құнды.

ralph-tui-ді қолдануға болатын жағдайлар

Сізде мынадай жұмыстар бар:

• Тестілеуді толықтыру (әсіресе ескі жобаларда)
• Lint / format түзету
• Шағын рефакторинг (қайталанатын кодты жинақтау)
• Жаппай түрлерді қосу, шекараларды толықтыру
• Сұранысты бөлшектегеннен кейін тапсырмалар кезегі бойынша баяу жылжыту

Бұл жұмыстардың барлығының ортақ қасиеті бар: тапсырмалар көп, қайталану дәрежесі жоғары, қабылдауға болады, итерациялық түрде жылжытуға болады.

ralph-tui-ді күштеп қолдануға болмайтын жағдайлар

Сіз мынадай нәрселер істегіңіз келеді:

• Бір реттік үлкен рефакторинг, қабылдау стандарттары түсініксіз
• Сұраныстың өзі бұлыңғыр, сіздің миыңыздағы жасырын білімге сүйенеді
• Көптеген командааралық байланыс/растау қажет
• Сізден өнімді бағалауды талап етеді

Мұндай тапсырмаларда агенттік цикл тек хаосты күшейтеді.

Оның ralph-loop-тан (ralph-claude-code) айырмашылығы неде?

ralph-claude-code "Claude Code-тің автоматты басқару қосымшасына" көбірек ұқсайды: сценарий оны іске қосады, циклді іске қосады, шығуды анықтау, трафикті шектеу, ажыратқыш бәрі сіз үшін қамтамасыз етілген. Сізге "жылдамдық" керек, ол өте жылдам болады.

ralph-tui "агенттік циклдің инженерлік консоліне" көбірек ұқсайды: ол белгілі бір модельді дәнекерлемейді, белгілі бір тапсырма жүйесін де дәнекерлемейді. Ол "ұзақ мерзімді жұмыс, бақылауға болатын, басқаруға болатын, қалпына келтіруге болатын, қашықтан басқаруға болатын" сияқты инженерлік мәселелерді шешуді көздейді.

Сондықтан сіз менен қалай таңдау керектігін сұрасаңыз?

• Сіз Claude Code пайдаланушысысыз және оны тез іске қосқыңыз келеді → ralph-claude-code
• Сіз әртүрлі модельдерді қосқыңыз келеді, ақша үнемдегіңіз келеді, циклді қызмет ретінде басқарғыңыз келеді → ralph-tui

Соңында: оның сіздің қоймаңызды зертхана ретінде пайдалануына жол бермеңіз

Менің агенттік циклді іске қосудың бірнеше қағидалары бар, оларды осында жазып қояйын, соған сәйкес әрекет етсеңіз, сәтсіздікке ұшырау ықтималдығы азаяды:

• Бұтақтарды пайдаланып іске қосыңыз, main-де өміріңізді құртпаңыз.
• Бірінші рет іске қосқанда міндетті түрде --iterations қосыңыз, алдымен оның есінен адаспайтынына көз жеткізіңіз.
• Тапсырма қабылдауға жарамды болуы керек: не тест іске қосылуы керек, не lint іске қосылуы керек, не шығыс файлдарын салыстыруға болады.
• Тоқтауды үйренуіңіз керек: оның айналып жүргенін көрсеңіз, ақшаны жағуды жалғастырғаннан гөрі тоқтатқан ақылдырақ.
• Арзан модельдер қара жұмысты істейді, қымбат модельдер маңызды жұмысты істейді: шығындар дұға ету арқылы емес, басқару арқылы пайда болады.Жоба мекенжайы: https://github.com/subsy/ralph-tui