К основному содержанию
скилл CX Codex

ralph-loop — скилл для Claude Code: итерации до готовности

Скилл запускает цикл, в котором агент получает одну и ту же задачу заново после каждого хода и видит свою прошлую работу.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cursor/plugins --skill ralph-loop -a claude-code
Открыть на GitHub

Что делает ralph-loop

Ralph Loop — это режим, где один и тот же промпт возвращается агенту после каждого завершённого хода. Агент видит, что уже сделал в прошлых итерациях, и продолжает с того места, а не начинает заново. Пригодится, когда задача большая и за один проход не закрывается.

При запуске скилл создаёт каталог .cursor/ralph/ и файл .cursor/ralph/scratchpad.md с YAML-шапкой: номер итерации, лимит max_iterations и completion_promise. Ниже в файл ложится ваш промпт. Дальше цикл держит stop hook: он перехватывает конец хода и подкидывает тот же текст как followup-сообщение с пометкой [Ralph loop iteration N.].

max_iterations по умолчанию равен 0, то есть без ограничения. Автор советует задавать лимит как страховку. Выход из цикла — только через <promise>TEXT</promise>, и выводить его можно, когда условие выполнено по-настоящему. Если специальные символы в completion_promise, значение в шапке берите в кавычки.

Какие задачи решает

  • довести большую задачу до конца за много проходов агента
  • не терять контекст между итерациями одной работы
  • задать условие остановки вместо бесконечного цикла
  • ограничить число итераций, чтобы агент не крутился впустую
  • запустить автономную доработку по одному промпту

Примеры запросов агенту

  • Запусти Ralph loop: собери REST API для задач с CRUD, валидацией и тестами, максимум 20 итераций, обещание завершения COMPLETE
  • Начни ralph loop для рефакторинга модуля оплаты, без лимита итераций
  • Запусти итеративный цикл над задачей: починить падающие тесты в tests/api, остановка по promise DONE

Как установить ralph-loop

1Через Skills CLI (Vercel)

npx skills add cursor/plugins --skill ralph-loop -a claude-code

2Вручную: положить файлы

~/.claude/skills/ralph-loop/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ralph-loop/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ralph-loop

Как установить ralph-loop в Claude Code?

Выполните npx skills add cursor/plugins --skill ralph-loop -a claude-code. Скилл встанет в ~/.claude/skills/ralph-loop/SKILL.md.

Что делает ralph-loop?

Заводит файл состояния .cursor/ralph/scratchpad.md с вашим промптом и параметрами, после чего stop hook возвращает тот же промпт агенту в конце каждого хода, пока не сработает условие остановки или лимит итераций.

Как цикл понимает, что пора остановиться?

По completion_promise: агент выводит <promise>TEXT</promise> только тогда, когда условие действительно выполнено. Ложные обещания ради выхода из цикла запрещены, а max_iterations работает как страховка.

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. 1 052 851установок ask-matt Matt Pocock Помогает выбрать подходящий скилл или рабочий поток из набора Matt Pocock. Пригодится, когда непонятно, с чего начать задачу: от идеи до разбора бага. 766 587установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. CX Codex 282 859установок caveman-review JuliusBrussee Пишет замечания к коду одной строкой: место, проблема, исправление. Пригодится, когда ревью диффа или PR надо пройти быстро и без воды. CX Codex +1 411 800установок caveman-compress JuliusBrussee Сжимает CLAUDE.md, списки задач и другие текстовые файлы в краткий формат, сохраняя читаемую резервную копию. CX Codex +1 411 500установок

Из того же набора45

create-plugin-scaffold Собирает каркас плагина Cursor: манифест, каталоги компонентов и запись в marketplace. Пригодится, когда начинаете плагин с нуля. CX Codex +1 1 200установок docs-canvas Скилл превращает архитектурные заметки, описания API и руководства в интерактивный холст для Cursor. Пригодится, когда вместо длинного markdown-файла нужен структурированный документ с навигацией. CX Codex +1 1 200установок orchestrate Скилл разбивает крупную задачу на параллельную работу облачных агентов Cursor и собирает их отчёты. Запускается только явной командой /orchestrate. CX Codex +1 1 200установок cursor-sdk Скилл для тех, кто запускает агентов Cursor из TypeScript: подсказывает схему вызова, рантайм и разбор ошибок. CX Codex +1 1 200установок create-learning-path Скилл строит учебный маршрут по теме: разбивает её на этапы, добавляет проекты-вехи и упражнения для практики. CX Codex +1 977установок run-learning-retrospective Скилл проводит ретроспективу обучения: сверяет сделанное с целями, находит повторяющиеся блокеры и правит план. Пригодится, когда закрыт очередной этап. CX Codex +1 902установок cancel-ralph Останавливает запущенный цикл Ralph и очищает временные файлы состояния. Пригодится, когда агент зациклился или задачу нужно прервать вручную. CX Codex +1 901установок ralph-loop-help Скилл отвечает на вопросы про технику Ralph Loop: как устроен цикл, какие есть опции и когда её брать в работу. CX Codex +1 899установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой