Ralph
Bash-цикл, который заново запускает Claude Code или Amp с чистым контекстом, пока все истории из PRD не пройдут проверки, и два скилла для PRD
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Запускает Claude Code с флагом --dangerously-skip-permissions и Amp с --dangerously-allow-all, поэтому агент выполняет любые команды без подтверждения
- Сам создает ветки и делает коммиты в репозитории проекта
- Работает без надзора до 10 итераций по умолчанию, и каждая расходует запросы к модели
Установка
Ручная установка
/plugin marketplace add snarktank/ralph
/plugin install ralph-skills@ralph-marketplaceСтавит скиллы /prd и /ralph. Скрипт ralph.sh в плагин не входит, его копируют в проект следующим способом.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Запускает Claude Code с флагом --dangerously-skip-permissions и Amp с --dangerously-allow-all, поэтому агент выполняет любые команды без подтверждения
- Сам создает ветки и делает коммиты в репозитории проекта
- Работает без надзора до 10 итераций по умолчанию, и каждая расходует запросы к модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ralph — скрипт ralph.sh, который в цикле запускает Claude Code или Amp, каждый раз новым экземпляром с чистым контекстом. За одну итерацию агент берет из prd.json самую приоритетную невыполненную историю, реализует ее, проверяет типы и прогоняет тесты, а при успехе делает коммит и отмечает историю выполненной. Память между итерациями хранят история git, журнал progress.txt с выводами прошлых проходов и сам prd.json. Цикл останавливается, когда выполнены все истории или исчерпан лимит итераций, по умолчанию 10. Вход для цикла готовят два скилла из плагина: prd задает уточняющие вопросы и пишет PRD в Markdown, ralph переводит его в prd.json.
Для кого. Для разработчиков на Claude Code и Amp, которые готовы отдать агенту функцию целиком, разбив ее на мелкие истории с проверяемыми критериями.
Подходит, если
- Функция делится на мелкие истории, и каждая помещается в одно окно контекста
- В проекте есть проверка типов, тесты и CI, по которым агент поймет, что история готова
- Длинная задача не помещается в одну сессию агента, и контекст переполняется
- Нужно сначала составить PRD по уточняющим вопросам, а потом выполнить его без участия человека
Не подходит, если
- Задача не дробится на шаги: целый дашборд или вся аутентификация за одну итерацию не помещаются
- В проекте нет тестов и проверки типов, поэтому ошибки накапливаются от итерации к итерации
- Агенту нельзя выполнять команды и делать коммиты без вашего подтверждения
Пример запроса к агенту
Загрузи скилл prd и составь PRD для фильтра задач по приоритетуОграничения
Нужны установленный и авторизованный Amp CLI или Claude Code, утилита jq и git-репозиторий проекта. Скрипт поддерживает два движка: Amp по умолчанию и Claude Code с флагом --tool claude. Плагин для Claude Code ставит только скиллы prd и ralph, а ralph.sh и шаблон промпта копируют в проект вручную. Цикл работает локально, но Claude Code и Amp обращаются к API своих моделей, и из России для этого обычно нужен VPN.
Как отключить. Остановите цикл сочетанием Ctrl+C и удалите папку scripts/ralph из проекта. Плагин удаляется командой /plugin uninstall ralph-skills@ralph-marketplace, скопированные вручную скиллы удаляются из ~/.claude/skills или ~/.config/amp/skills.
Частые вопросы
Чем Ralph отличается от одной длинной сессии агента?
Каждая итерация стартует с чистым контекстом и берет одну историю. Знания между итерациями переходят через коммиты, progress.txt и prd.json, поэтому на большой задаче контекст модели не переполняется.
Что ставит плагин из маркетплейса?
Два скилла для Claude Code. Скилл /prd задает 3–5 уточняющих вопросов и сохраняет PRD в tasks/prd-[название].md, скилл /ralph переводит этот документ в prd.json. Скрипт цикла в плагин не входит, его копируют в проект.
Насколько безопасен цикл?
Скрипт запускает Claude Code с флагом --dangerously-skip-permissions, а Amp с --dangerously-allow-all, поэтому агент выполняет команды и коммитит без подтверждений. Для первого прогона возьмите копию репозитория или контейнер и малый лимит, например ./scripts/ralph/ralph.sh --tool claude 3.
Похожие
ВоркфлоуНабор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Коротко о README
README описывает Ralph как реализацию паттерна Джеффри Хантли и дает три способа установки: копирование файлов в проект, ручную установку скиллов для Amp и Claude Code и маркетплейс плагинов Claude Code. Работа идет в три шага: PRD через скилл prd, перевод в prd.json скиллом ralph и запуск ralph.sh. Отдельные разделы объясняют, почему истории должны быть маленькими, зачем агент дописывает выводы в AGENTS.md и почему без тестов и проверки типов цикл копит ошибки. Для историй с интерфейсом автор советует добавлять в критерии проверку в браузере скиллом dev-browser. В конце даны команды отладки через jq и git log.
Бейдж для README
Вы автор проекта? Покажите в README, что он проверен в каталоге SkillFoxx. Уровень на бейдже обновляется сам.
[](https://skillfoxx.ru/workflows/ralph?utm_source=github&utm_medium=badge&utm_campaign=readme)