Скил dr-next-snapshot-replay — потребительский контракт снапшота стадии
Как /dr-next читает снапшот стадии, валидирует его, собирает промпт для возобновления и направляет к нужной следующей команде — не перечитывая всю историю задачи.
При каждом запуске /dr-next первым делом ищет снапшот в datarim/snapshots/{TASK-ID}.snapshot.md. Скил dr-next-snapshot-replay описывает точный контракт для того, что происходит дальше: как снапшот валидируется, какой промпт формируется при успехе и что происходит в случае неудачи.
Валидация перед использованием
Снапшот не используется на доверии. Скрипт-валидатор — check-stage-snapshot-on-exit.sh --validate-frontmatter --task <ID> — должен завершиться с кодом 0, прежде чем содержимое снапшота войдёт в промпт возобновления. Если скрипт возвращает любой другой код, скил молча переключается на стандартный конвейер чтения: task-description, init-task, activeContext, в таком порядке. Никаких предупреждений, никаких прерываний — оператор просто получает чуть более медленный, но полный путь восстановления.
Такая политика отката существует потому, что повреждённый или неполный снапшот хуже, чем его отсутствие. Молчаливый откат означает, что оператору никогда не нужно вручную очищать плохой снапшот перед возобновлением.
Промпт воспроизведения
При успешной валидации скил формирует промпт воспроизведения фиксированной формы. Промпт открывается значением recommended_next из frontmatter снапшота — командой, которую предыдущая стадия предложила как естественное продолжение — за которым следует двуязычный блок выполнения. Этот блок присутствует на русском и английском в каждом промпте воспроизведения, вне зависимости от локали рантайма. Причина практическая: /dr-next работает под Claude Code, Codex CLI и агентами с английской локалью. Двуязычный блок гарантирует, что инструкция по выполнению достигнет модели независимо от активного рантайма.
Далее следует тело снапшота под буквальным заголовком done before:, давая модели компактную запись о том, что уже было выполнено.
Как выбирается рекомендованная команда
Скил описывает эвристику для оценки подсказки recommended_next из снапшота. Основной принцип — максимизировать предельное улучшение качества решения. Для сложной задачи, только что завершившей план, но имеющей мало проходов верификации, /dr-verify предпочтительнее прямого перехода к /dr-do: верификационный вердикт обходится значительно дешевле, чем откат реализации, построенной на необнаруженном расхождении. Когда верификация исчерпана и реализация завершена, /dr-archive — логичный следующий шаг.
Оператор всегда может переопределить рекомендацию, введя другую команду. Промпт воспроизведения показывает предложение, но не блокирует переопределение.
Откуда берётся снапшот
Производящая сторона — скил stage-snapshot-writer, который запускается в конце каждой стадии конвейера и записывает файл снапшота, читаемый этим скилом позже. Потребительский контракт здесь — dr-next-snapshot-replay — описывает только сторону чтения. Плагин-оркестратор интегрирует этот же контракт перед своим резолвером подагентов, передавая recommended_next как подсказку, которую резолвер может принять или переопределить.
Смотрите также: пост о команде /dr-next для поведения на уровне команды и пост что такое Datarim для общего контекста.