Перейти к содержимому
provod.ai
Гайды

Код запускается, а игра работает не так: как сохранить её правила

На примере расхода энергии разбираемся, почему одних инструкций для помощника мало и как проверить результат правки.

Автор
provod.ai
Опубликовано
Обновлено
Категория
Гайды
Время чтения
Чтение: 6 мин
Правило игры: энергия ≥ 0
Правило игры: энергия ≥ 0

По правилам игры действие должно тратить одну единицу энергии. Помощник поправил код, игра запускается — но персонаж теперь действует даже с пустой шкалой. «Ты же читал описание!» Здесь проблема может быть не в забывчивости: правило могли найти, но не сохранить при изменении программы. На этом учебном примере разберёмся, как довести инструкцию до поведения в игре.

Иллюстрация правила из статьи: значение не должно уйти ниже нуля.

Повод для разбора — рассказ разработчика Zill от 30 октября. По его опыту, подготовленные инструкции и справочные материалы помогли, но не сделали создание игры с ИИ предсказуемым. Это личное наблюдение автора, а не сравнительный тест моделей. Исходное сообщение.

Что показал исходный опыт

Zill описывает большую подготовительную работу: подбор материалов, оформление справочных файлов, индексацию и настройку приёмов работы с агентом. По его оценке, качество стало несколько устойчивее, однако это не превратило разработку в предсказуемое производство готовых игр.

Такой рассказ нельзя использовать как доказательство, что любая модель обязательно провалится на вашем проекте. Он не даёт сопоставимых замеров и не отделяет влияние модели от устройства проекта. Зато хорошо показывает границу ожиданий: доступ к большому объёму знаний ещё не равен умению каждый раз правильно собрать из них рабочую систему.

Для игры эта граница особенно заметна. Код может запускаться, а правила боя, экономика и впечатление от управления — постепенно расходиться с замыслом.

«Файл есть» и «правило использовано» — разные проверки

У нашего правила про энергию несколько мест в проекте: описание механики, код расхода, кнопка действия и проверки. В описании всё может быть верно, а в коде — уже нет. Игрок при этом видит одну ошибку: пустая шкала не мешает действовать.

Попросите помощника перед изменением назвать действующее условие и указать файл, где оно описано. Если он не может его найти, проблема начинается ещё до написания кода. Добавлять в запрос всё устройство игры в таком случае необязательно: сначала нужен понятный вход к нужной механике.

Если условие найдено, следующий вопрос — где оно проверяется. Заблокированная кнопка сама по себе не защищает правило: действие может вызываться другим путём. Изменение должно сохранять ограничение в той части программы, которая действительно выполняет действие.

Эта проверка помогает отличить потерю документа от ошибки реализации. Лечатся они по-разному.

Отделите действующие правила от идей на будущее

Один огромный файл кажется удобным, пока в нём не оказываются одновременно обязательные правила, идеи будущих обновлений, описания других игр и уже отменённые решения.

Полезнее иметь короткий входной документ и несколько предметных разделов. Вход объясняет устройство проекта и указывает, где искать механику, интерфейс, сохранения и проверку изменений. Подробности открываются по необходимости.

В документации Claude Code похожее разделение проводится между инструкциями проекта и автоматически сохраняемой памятью. Файлы правил помогают задать ожидания, но сами по себе не становятся программной гарантией их выполнения. Работа с инструкциями и памятью проекта.

МатериалЧто в нём полезно держатьЧто лучше отделить
Правила механикиДействующие условия и исключенияИдеи, которые ещё не утверждены
Решения командыВыбор и причины, дата измененияЧерновое обсуждение без итогового решения
Справочные материалыСсылки и объяснение, что из них используетсяТребование копировать чужую игру целиком
Проверка измененияНаблюдаемый результат и способ повторитьОбщее пожелание «сделать хорошо»

Таблица: организация контекста для работы с конкретной механикой, а не обязательная структура папок.

Важно различать намерение и состояние. Фраза «хотим добавить восстановление энергии» не должна выглядеть как описание уже работающей функции. А старое решение должно явно уступать место новому.

Проверьте правило в самой игре

Для нашего примера недостаточно увидеть красивую анимацию действия. Нужно проверить три состояния: энергии достаточно, энергия равна нулю и два действия запрашиваются подряд на остатке в одну единицу.

Последний случай полезен тем, что проверяет поведение, а не только показ кнопки. Не требуется заранее считать модель некомпетентной: проверка просто фиксирует то, что игра должна сохранять после любой правки.

Критерий можно записать коротко:

plaintext
Действие уменьшает энергию ровно на 1.
При энергии 0 действие не выполняется.
Два последовательных запроса не делают энергию отрицательной.

Это учебный пример условий, а не готовый тестовый код. Способ автоматической проверки зависит от движка и архитектуры проекта. Главное — сделать результат наблюдаемым: какое действие выполнено, какое состояние осталось и какое условие сохранено.

Чтобы сформулировать такие условия, можно попросить текстовую модель выделить из описания механики правила и исключения. Например, сделать это в provod.ai, затем проверить формулировки самому. Помощник помогает подготовить основу проверки; соответствие реальной реализации всё равно устанавливается в проекте.

В учебной игровой механике при энергии 1 действие тратит единицу, а при энергии 0 блокируется и не меняет остаток.

Проверка границы в механике из статьи: действие расходует одну единицу энергии, при нуле не выполняется. Отдельно нужно проверить два последовательных запроса на остатке в одну единицу.

Меняйте один связанный участок и смотрите последствия

Широкий запрос вроде «улучши бой и заодно приведи код в порядок» смешивает разные работы. После большой правки сложнее понять, почему изменился расход энергии: это было намерением, побочным эффектом или ошибкой.

Узкая задача позволяет связать описание, изменённый участок и результат. Например: добавить визуальную подсказку о недоступном действии, сохранив действующий расчёт энергии. После неё можно проверить и подсказку, и прежнее ограничение.

Узкая задача не обязательно помещается в один файл. Для подсказки может понадобиться изменить экран, а для ограничения — код действия. Важно сохранить одну понятную цель, а не запретить помощнику видеть связанные части игры.

После изменения просите показать, что именно было проверено. Успешная сборка подтверждает сборку. Прохождение теста расхода энергии подтверждает конкретный тест. Ни то ни другое отдельно не доказывает, что бой интересен игроку.

Тесты не скажут, интересно ли играть

Условия можно проверять автоматически, но ощущение темпа, понятность обратной связи и интерес к выбору не сводятся к одному признаку. Эти стороны игры нужно смотреть в движении и давать пробовать людям.

Полезно разделить приёмку: сначала игра соблюдает обязательные правила, затем команда оценивает качество опыта. Тогда обсуждение «мне не нравится, как ощущается действие» не теряется среди ошибок подсчёта.

Хорошо подготовленный контекст уменьшает лишние поиски и недоразумения. Он не снимает необходимость выбирать решения, проверять изменения и возвращаться к замыслу. Именно в таком сочетании помощь ИИ становится устойчивее: короткий путь к актуальному правилу, предметная задача и проверка результата в самой игре.

Источники