Ralph Wiggum — скилл
Автономный цикл разработки по спецификациям: агент берет задачу, сверяет критерии приемки и коммитит, пока список не кончится.
- 311 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Автономный цикл меняет код, коммитит и пушит на каждой итерации без отдельного подтверждения.
- Агент получает значительную автономию над проектом и системой, поэтому запуск без изоляции опасен для остального кода.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/ralph-wiggumОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Автономный цикл меняет код, коммитит и пушит на каждой итерации без отдельного подтверждения.
- Агент получает значительную автономию над проектом и системой, поэтому запуск без изоляции опасен для остального кода.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ralph Wiggum запускает ИИ-агента в цикле: каждая итерация берет одну спецификацию из `specs/`, реализует ее, проверяет критерии приемки и коммитит результат. Метод основан на итеративном bash-цикле Джеффри Хантли и добавляет к нему спецификации в стиле SpecKit. Скрипт ищет в ответе метку `<promise>DONE</promise>`. Агент выводит ее только после выполнения всех критериев и прохождения тестов, а без метки итерация повторяется. Каждый проход стартует с чистого контекста, а состояние хранится на диске: файл `IMPLEMENTATION_PLAN.md`, счетчик попыток в комментарии спецификации и журналы в `logs/`. Скрипты есть для Claude Code, Codex, Gemini и Copilot, в вариантах для bash и PowerShell. Установку ведет сам агент по `INSTALLATION.md`: короткое интервью о проекте и создание «конституции» с правилами для будущих сессий.
Для кого. Разработчикам, которые готовы отдать агенту очередь спецификаций и проверять результат тестами и журналами.
Подходит, если
- Есть набор спецификаций с проверяемыми критериями приемки, и их надо реализовать подряд без ручных запусков агента.
- Длинная сессия переполняет контекст, и каждую задачу лучше начинать с чистого окна.
- Спецификация застряла после десяти попыток, и ее пора разбить на части.
- Ход работы хочется видеть в Telegram: старт цикла, готовые спецификации, предупреждения.
- Тот же цикл запускают в Codex, Gemini или Copilot вместо Claude Code.
Не подходит, если
- Спецификаций нет, а критерии приемки расплывчаты: цикл не отличит готовую работу от неготовой.
- В репозитории лежит важный код, а изоляции нет: инструмент получает значительную автономию над кодом и системой.
- Пуши без вашей проверки недопустимы: итерация заканчивается коммитом и пушем.
- Нужна разовая небольшая правка: разворачивать конституцию и цикл ради нее лишнее.
Пример запроса к агенту
Настрой Ralph Wiggum в моем проекте по репозиторию https://github.com/fstandhartinger/ralph-wiggum и объясни, как писать спецификации.Ограничения
Репозиторий предупреждает, что инструмент дает агенту значительную автономию над кодом и системой: запускать его советуют в изолированной среде и просматривать все изменения. Качество результата определяют критерии приемки в спецификациях и тесты, расплывчатые критерии ведут к повторным безрезультатным итерациям. Для необязательных уведомлений в Telegram нужны `TG_BOT_TOKEN` и `TG_CHAT_ID`, для голосовых еще `CHUTES_API_KEY`. Последний коммит сделан в мае 2026.
Как отключить. Остановите запущенный цикл, прервав процесс. Удалите скилл `ralph-wiggum` из каталога скиллов агента, а при полной настройке еще скрипты `scripts/ralph-loop*`, каталоги `specs/` и `.specify/` проекта.
Частые вопросы
Как поставить Ralph Wiggum как скилл?
Выполните `npx add-skill fstandhartinger/ralph-wiggum` или `openskills install fstandhartinger/ralph-wiggum`. Для полной настройки попросите агента выполнить `INSTALLATION.md`.
Как запустить цикл?
Положите спецификации в `specs/` и запустите `./scripts/ralph-loop.sh`. Число после команды ограничивает итерации, например `./scripts/ralph-loop.sh 20`. Режим `plan` строит `IMPLEMENTATION_PLAN.md` и необязателен.
Как цикл понимает, что задача выполнена?
Агент выводит `<promise>DONE</promise>` только после проверки всех критериев приемки, прохождения тестов, коммита и пуша. Если метки нет, скрипт повторяет итерацию.
Что делать со спецификацией, которая не проходит?
После десяти попыток она считается застрявшей. Счетчик хранится в комментарии `<!-- NR_OF_TRIES: 5 -->`, а сводку печатает `print_stuck_specs_summary`. Такую спецификацию делят на меньшие.
Можно ли запускать цикл в Codex?
Да: `./scripts/ralph-loop-codex.sh`, для планирования с параметром `plan`. Есть варианты для Gemini и Copilot, а для Windows файлы `.ps1`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыКоманда ralph повторяет один промпт для Claude Code, Codex, Cursor Agent или OpenCode, пока в ответе не появится метка завершения
Цикл Ральфа для длинных задач: агент в песочнице Docker идет по списку задач из PRD, проверяет каждую тестами и коммитит, пока список не кончится
CLI-оркестратор, который прогоняет Claude Code, Codex, Gemini CLI и другие агенты по циклу до готовности задачи и блокирует неполную работу тестами и линтером
Терминальная панель, которая ведет Claude Code, Codex и еще пять агентов по списку задач циклом, пока список не закончится
Скилл и команда /looper для Claude Code: через интервью строит цикл агента с проверкой, независимым рецензентом и стоп-условиями до запуска
Автономное выполнение плана по задачам: каждая задача в свежем сеансе Claude Code или Codex, затем многопроходное ревью. Написан на Go
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Ralph Wiggum (эта карточка) | нет | 311 | |
| Open Ralph Wiggum | нет | 1 908 | команда ralph, которая повторяет один промпт, пока не появится метка завершения; здесь цикл работает по спецификациям с критериями приемки и счетчиком попыток |
| Ralph Loop by PageAI | нет | 337 | цикл в песочнице Docker по списку задач из PRD; здесь спецификации в стиле SpecKit и установка силами самого агента |
Коротко о README
Документ излагает метод Хантли с добавлением спецификаций SpecKit и двумя режимами: сборка и необязательное планирование. Принципы названы прямо: чистый контекст на каждом проходе, состояние на диске, тесты как обратная связь, проверка завершения. Дальше идут варианты источника спецификаций (файлы, задачи GitHub, свой механизм) и совместимость с установщиками скиллов.
Бейдж для README
Исходный SKILL.md
--- name: ralph-wiggum description: Autonomous AI coding with spec-driven development. Implements Geoffrey Huntley's iterative bash loop methodology where agents work through specs one at a time, outputting a completion signal only when acceptance criteria are 100% met. license: MIT metadata: author: fstandhartinger version: "1.0" repository: https://github.com/fstandhartinger/ralph-wiggum website: https://ralph-wiggum.ai --- # Ralph Wiggum > Autonomous AI coding with spec-driven development ## What is Ralph Wiggum? Ralph Wiggum combines **Geoffrey Huntley's iterative bash loop** with **spec-driven development** for fully autonomous AI-assisted software development. The key insight: **Fresh context each iteration**. Each loop starts a new agent process with a clean context window, preventing context overflow and degradation. ## When to Use This Skill Use Ralph Wiggum when: - You have multiple specifications/features to implement - You want the AI to work autonomously through tasks - You need consistent, verifiable completion of acceptance criteria - You want to avoid context window problems in long sessions ## How It Works ``` ┌─────────────────────────────────────────────────────────────┐ │ RALPH LOOP │ ├─────────────────────────────────────────────────────────────┤ │ Loop 1: Pick spec A → Implement → Test → Commit → DONE │ │ Loop 2: Pick spec B → Implement → Test → Commit → DONE │ │ Loop 3: Pick spec C → Implement → Test → Commit → DONE │ │ ... │ │ │ │ Each iteration = Fresh context window │ │ Shared state = Files on disk (specs, plan, history) │ └─────────────────────────────────────────────────────────────┘ ``` ## Installation ### Quick Install (via Skill Installers)