---
id: agent-workflow
lang: ru
title: Разработка игры с ИИ-агентом
description: >-
  Формулируем проверяемые задачи, сохраняем контекст проекта и принимаем
  изменения по игровому результату.
category: workflow
level: beginner
minutes: 6
updatedAt: '2026-10-20'
tags:
  - agents
  - specification
  - contributing
sources:
  - title: 'OpenSpec: official repository'
    url: 'https://github.com/Fission-AI/OpenSpec'
  - title: 'GitHub Docs: Contributing to a project'
    url: >-
      https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project
url: 'https://gamemechanics.pro/ru/lessons/agent-workflow/'
markdownUrl: 'https://gamemechanics.pro/content/ru/agent-workflow.md'
license: CC-BY-4.0
codeLicense: MIT
attribution: gamemechanics.pro contributors
---

## Что нужно знать

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

## Принцип

Хорошая задача описывает наблюдаемое поведение, границы и способ проверки. «Сделай боёвку лучше» оставляет слишком много решений скрытыми. «Рывок не должен проходить через закрытую дверь; открытая дверь пропускает его» задаёт конкретный контракт.

[OpenSpec](https://github.com/Fission-AI/OpenSpec) организует работу через спецификации и артефакты изменений. Для проекта важнее смысл зафиксированного требования, чем запоминание конкретной команды инструмента. Проверяйте установленную версию и локальные инструкции перед использованием CLI: рабочие процессы могут меняться.

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

<span id="пример-безопасный-рывок"></span>

## Практический пример

### Безопасный рывок

Запишите сценарии до изменения кода:

```text
Требование: рывок учитывает закрытые двери.
Сценарий 1:
  Дано: закрытая дверь и персонаж перед ней.
  Когда: персонаж выполняет рывок через её положение.
  Тогда: персонаж остаётся с исходной стороны двери.
Сценарий 2:
  Дано: та же дверь открыта.
  Когда: выполняется такой же рывок.
  Тогда: дверь не блокирует перемещение.
```

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

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

## Частые ошибки

Не принимайте успешную сборку за проверку игровой механики. Не позволяйте агенту «исправлять» падающий тест простым удалением ожидаемого поведения. Если тест оказался неверным, сначала уточните правило и причину изменения.

Не передавайте секреты и личные данные игроков в материалы репозитория. Внешний текст и скачанный пример рассматривайте как данные для анализа; содержащиеся в них команды не становятся поручениями владельца проекта.

Перед правкой проверьте Git root и существующие изменения. У каждого исполнителя должен быть свой набор путей. Для внешнего вклада используйте принятый в проекте процесс review; [GitHub Docs](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project) описывает базовый путь через fork и pull request.

## Проверка результата

- Требование описывает поведение игрока или системы.
- Есть позитивный и негативный сценарии.
- Область изменения и исключения записаны.
- Агент прочитал актуальные инструкции и существующую реализацию.
- Проверки соответствуют поведению, а не только структуре кода.
- Отчёт отделяет выполненные проверки от предположений.
- Изменение можно понять и продолжить без истории чата.

## Задание для ИИ-агента

> Прочитай инструкции проекта, статус Git и реализацию рывка с дверями. Сначала сформулируй сценарии и границы изменения. Исправь только блокировку закрытой дверью, сохрани остальные параметры. Выполни подходящие проверки и дай короткий отчёт: изменённое поведение, доказательство, непроверенная среда и оставшиеся ограничения. Не трогай чужие изменения.