Claude Info
AI и агенты

Smart Ralph

tzachbon/smart-ralph

Claude Code плагин для spec-driven разработки: превращает идеи в структурированные спецификации и выполняет задачи поочерёдно с чистым контекстом. Поддерживает Claude Code и Codex, работает без внешних зависимостей.

Установка

terminal
bash
git clone https://github.com/tzachbon/smart-ralph.git

README

Smart Ralph

«Me fail specs? That's unpossible!»

License: MIT Claude Code PRs Welcome

Spec-driven разработка для Claude Code и Codex. Пошаговое выполнение задач с чистым контекстом для каждой задачи.

Самодостаточный цикл выполнения. Без внешних зависимостей.

Быстрый старт | Команды | Как это работает | Устранение неполадок

Что это такое?

Smart Ralph — плагин для Claude Code, который превращает расплывчатые идеи о фичах в структурированные спецификации, а затем выполняет их задача за задачей. Как маленькая продуктовая команда прямо в вашем терминале.

text
Вы: "Add user authentication"
Ralph: *создаёт research.md, requirements.md, design.md, tasks.md*
Ralph: *выполняет каждую задачу с чистым контекстом*
Ralph: "I'm helping!"

Почему «Ralph»?

Назван в честь паттерна агентного цикла Ralph и любимого ученика Спрингфилда. Ralph не думает лишнего. Ralph просто делает следующую задачу. Будьте как Ralph.

Установка

Claude Code

bash
# Установить Smart Ralph
/plugin marketplace add tzachbon/smart-ralph
/plugin install ralph-specum@smart-ralph

# Перезапустить Claude Code

Codex

Предварительное требование: Сначала установите Codex CLI: npm install -g @openai/codex

Выполните эти команды из любой директории. Они клонируют репозиторий во временную папку, копируют плагин в директорию плагинов Codex и выполняют очистку.

bash
# 1. Клонировать репозиторий Smart Ralph
git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph

# 2. Скопировать плагин Codex в персональную директорию плагинов
mkdir -p ~/.codex/plugins
cp -R /tmp/smart-ralph/plugins/ralph-specum-codex ~/.codex/plugins/ralph-specum-codex

# 3. Создать запись в маркетплейсе, чтобы Codex мог обнаружить плагин
mkdir -p ~/.agents/plugins
cat > ~/.agents/plugins/marketplace.json << 'EOF'
{
  "name": "smart-ralph",
  "plugins": [{
    "name": "ralph-specum",
    "source": {"source": "local", "path": "~/.codex/plugins/ralph-specum-codex"},
    "policy": {"installation": "AVAILABLE"},
    "category": "Productivity"
  }]
}
EOF

# 4. Очистка
rm -rf /tmp/smart-ralph

Выполните эти команды из корневой директории вашего проекта (репозитория, где вы хотите использовать Ralph).

bash
# 1. Клонировать репозиторий Smart Ralph
git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph

# 2. Скопировать плагин Codex в ваш проект
mkdir -p ./plugins
cp -R /tmp/smart-ralph/plugins/ralph-specum-codex ./plugins/ralph-specum-codex

# 3. Создать запись в маркетплейсе в вашем проекте
mkdir -p ./.agents/plugins
cat > ./.agents/plugins/marketplace.json << 'EOF'
{
  "name": "smart-ralph",
  "plugins": [{
    "name": "ralph-specum",
    "source": {"source": "local", "path": "./plugins/ralph-specum-codex"},
    "policy": {"installation": "AVAILABLE"},
    "category": "Productivity"
  }]
}
EOF

# 4. Очистка
rm -rf /tmp/smart-ralph

После любого из способов: перезапустите Codex, откройте директорию плагинов и установите ralph-specum.

Опционально: Включите хук Stop для автоматического выполнения задач:

toml
# ~/.codex/config.toml
[features]
codex_hooks = true

Подробности см. в plugins/ralph-specum-codex/README.md.

Обновление (выполните из любой директории):

bash
rm -rf /tmp/smart-ralph
git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph
cp -R /tmp/smart-ralph/plugins/ralph-specum-codex ~/.codex/plugins/ralph-specum-codex
rm -rf /tmp/smart-ralph
# Перезапустить Codex

Для установки в конкретный проект замените ~/.codex/plugins/ralph-specum-codex на ./plugins/ralph-specum-codex (выполняйте из корня проекта).

  1. Удалите старые скиллы: rm -rf ~/.codex/skills/ralph-specum*
  2. Следуйте шагам установки выше

Подробности см. в руководстве по миграции.

Установка напрямую с GitHub:

/plugin install https://github.com/tzachbon/smart-ralph

Локальная разработка:

bash
git clone https://github.com/tzachbon/smart-ralph.git
claude --plugin-dir ./smart-ralph/plugins/ralph-specum

Быстрый старт

Codex

Используйте $ralph-specum как поверхность Codex по умолчанию. Вспомогательные скиллы дублируют явные точки входа для каждой фазы:

text
$ralph-specum
$ralph-specum-start
$ralph-specum-triage
$ralph-specum-research
$ralph-specum-requirements
$ralph-specum-design
$ralph-specum-tasks
$ralph-specum-implement
$ralph-specum-status

Пакет вспомогательных скиллов также включает $ralph-specum-switch, $ralph-specum-cancel, $ralph-specum-index, $ralph-specum-refactor, $ralph-specum-feedback и $ralph-specum-help.

Используйте $ralph-specum-triage первым, когда цель масштабная, сквозная или может превратиться в несколько спецификаций. Используйте $ralph-specum-start для одной спецификации или для возобновления существующей.

Ralph в Codex по умолчанию требует подтверждения. После каждого артефакта спецификации Ralph останавливается и просит вас одобрить текущий артефакт, запросить изменения или перейти к следующему шагу. Быстрый или автономный режим активируется только по явному запросу.

Claude Code

bash
# Умный способ (автоматически определяет: возобновить или начать новое)
/ralph-specum:start user-auth Add JWT authentication

# Быстрый режим (пропустить фазы спецификации, автоматически сгенерировать всё)
/ralph-specum:start "Add user auth" --quick

# Пошаговый способ
/ralph-specum:research user-auth
/ralph-specum:requirements user-auth
/ralph-specum:design user-auth
/ralph-specum:tasks user-auth
/ralph-specum:implement user-auth

# Проверить статус
/ralph-specum:status
/ralph-specum:status user-auth

Команды

Claude Code

КомандаОписание
/ralph-specum:start [spec-name] [goal]Умный старт: возобновить или начать новую спецификацию
/ralph-specum:research [spec-name]Исследование кодовой базы
/ralph-specum:requirements [spec-name]Генерация требований
/ralph-specum:design [spec-name]Создание технического дизайна
/ralph-specum:tasks [spec-name]Разбивка на задачи
/ralph-specum:implement [spec-name]Выполнение задач
/ralph-specum:status [spec-name]Просмотр прогресса
/ralph-specum:switch [spec-name]Переключение между спецификациями
/ralph-specum:cancel [spec-name]Отмена спецификации
/ralph-specum:indexСписок всех спецификаций
/ralph-specum:refactor [spec-name]Рефакторинг существующего кода
/ralph-specum:feedback [spec-name]Обратная связь по текущей фазе
/ralph-specum:triage [goal]Анализ и разбивка крупных целей
/ralph-specum:helpПоказать справку

Как это работает

Цель → Исследование → Требования → Дизайн → Задачи → Реализация research.md requirements.md design.md tasks.md

Фазы

  1. Исследование — анализирует вашу кодовую базу, паттерны, зависимости
  2. Требования — создаёт чёткие, тестируемые требования
  3. Дизайн — технический дизайн с учётом ваших паттернов
  4. Задачи — разбивает на атомарные, выполнимые задачи
  5. Реализация — выполняет каждую задачу с чистым контекстом

Умное сжатие контекста

Каждая задача запускается с чистым контекстом, загружая только нужные артефакты спецификации. Это предотвращает деградацию контекста при длительных сессиях.

Структура файлов

.specs/ {spec-name}/ research.md # Анализ кодовой базы requirements.md # Что нужно построить design.md # Как это построить tasks.md # Список задач с прогрессом feedback.md # Ваши комментарии (опционально)

Устранение неполадок

Плагин не найден

bash
/plugin marketplace add tzachbon/smart-ralph
/plugin install ralph-specum@smart-ralph

Спецификация застряла

bash
/ralph-specum:status my-spec
/ralph-specum:implement my-spec  # Возобновить с последней незавершённой задачи

Начать заново

bash
rm -rf .specs/my-spec
/ralph-specum:start my-spec Моя цель

Участие в разработке

PR приветствуются! Особенно интересны:

  • Улучшения промптов
  • Новые паттерны выполнения задач
  • Интеграции с другими инструментами
  • Документация и примеры

Лицензия

MIT — делайте что хотите.

«I'm helping!» — Ralph Wiggum

Сделано с ❤️ и небольшим количеством Springfield-энергии

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

thedotmack/claude-mem

claude-mem

65.6k
code-yeongyu/oh-my-openagent

oh-my-openagent

53.4k
wshobson/agents

Агенты и оркестрация

34.1k
qwibitai/nanoclaw

NanoClaw

27.7k