voiceover — команда для Claude Code: что делает и как установить
Команда voiceover запускает разработку фичи от демо: сначала согласовывает закадровый текст сценария, а затем создаёт отдельный git worktree, пишет код и открывает PR.
LicenseRef-Proprietary ★ 7 523 обновлён 2026-10-29
.claude/commands/voiceover.mdЧто делает voiceover
Команда заменяет классическое ТЗ закадровым текстом для демо-ролика. Сначала ассистент пишет пошаговый сценарий от лица пользователя, где каждый абзац описывает отдельный экран. Пока сценарий не утверждён, агент не трогает код проекта. Если кадр сложно озвучить простыми словами, логику фичи отправляют на доработку.
После одобрения текста создаётся изолированный каталог через git worktree от ветки dev. Сценарий сохраняется в файл evals/voiceovers/<flow-id>.md, а структура генерируется через pnpm fraimz scaffold. Реализация пишется и проверяется до тех пор, пока тесты fraimz не подтвердят каждый экран. Финал процесса — создание пулреквеста через gh pr create с прикреплением отчёта. Без установленных утилит fraimz и gh пайплайн застопорится на шаге проверки.
Какие задачи решает
- зафиксировать логику интерфейса через сценарий демо-ролика
- изолировать разработку новой функциональности в отдельном git worktree
- сгенерировать каркас сценария утилитой fraimz
- автоматизировать открытие пулреквеста с прикреплением отчёта
Примеры запросов агенту
- /voiceover Добавить экспорт отчёта в CSV
- /voiceover Сделать авторизацию по одноразовому коду из почты
Как установить voiceover
Вручную: положить файлы
.claude/commands/voiceover.mdВызов — /voiceover. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/voiceover.mdВызов — /prompts:voiceover. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/voiceover.prompt.mdВручную: положить файлы
.gemini/commands/voiceover.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о voiceover
Как установить voiceover в Claude Code?
Создайте файл .claude/commands/voiceover.md в корне репозитория и сохраните в него инструкцию команды.
Что делает команда voiceover?
Она организует разработку по методу demo-driven development: согласует закадровый текст пользовательского сценария вместо ТЗ, настраивает отдельное рабочее дерево git и координирует кодинг до прохождения тестов.
Какие инструменты нужны для работы voiceover?
Потребуются git с поддержкой worktree, gh для создания пулреквестов и пакет pnpm fraimz для валидации кадров сценария.