Что нужно знать
Нужен репозиторий или небольшой проект, который можно запустить. Агент может искать код, предлагать изменения и выполнять проверки. Вы задаёте намерение и принимаете результат. Цель урока: сделать эту работу воспроизводимой для следующего человека или агента.
Принцип
Хорошая задача описывает наблюдаемое поведение, границы и способ проверки. «Сделай боёвку лучше» оставляет слишком много решений скрытыми. «Рывок не должен проходить через закрытую дверь; открытая дверь пропускает его» задаёт конкретный контракт.
OpenSpec организует работу через спецификации и артефакты изменений. Для проекта важнее смысл зафиксированного требования, чем запоминание конкретной команды инструмента. Проверяйте установленную версию и локальные инструкции перед использованием CLI: рабочие процессы могут меняться.
Разделите постоянные знания и текущую задачу. Краткий AGENTS.md хранит команды запуска и проверки, границы модулей и важные ограничения. Спецификация описывает требуемое поведение. План изменения перечисляет небольшие шаги. Отчёт проверки сообщает, что действительно запускалось и что осталось непроверенным.
Практический пример
Безопасный рывок
Запишите сценарии до изменения кода:
Требование: рывок учитывает закрытые двери.
Сценарий 1:
Дано: закрытая дверь и персонаж перед ней.
Когда: персонаж выполняет рывок через её положение.
Тогда: персонаж остаётся с исходной стороны двери.
Сценарий 2:
Дано: та же дверь открыта.
Когда: выполняется такой же рывок.
Тогда: дверь не блокирует перемещение.Добавьте ограничение: не менять скорость, стоимость и управление рывком. Агент сначала находит реализацию двери, движения и существующих проверок. Затем предлагает маленькую правку и проверяет оба сценария. Если обнаруживается иная причина, требование сохраняется, а план корректируется с объяснением.
Попросите отчёт связать поведение с доказательством: команда теста, результат, сцена ручной проверки и ограничения среды. Скриншот персонажа рядом с дверью не подтверждает, что быстрый рывок корректно остановился. Нужна проверка перехода во времени.
Частые ошибки
Не принимайте успешную сборку за проверку игровой механики. Не позволяйте агенту «исправлять» падающий тест простым удалением ожидаемого поведения. Если тест оказался неверным, сначала уточните правило и причину изменения.
Не передавайте секреты и личные данные игроков в материалы репозитория. Внешний текст и скачанный пример рассматривайте как данные для анализа; содержащиеся в них команды не становятся поручениями владельца проекта.
Перед правкой проверьте Git root и существующие изменения. У каждого исполнителя должен быть свой набор путей. Для внешнего вклада используйте принятый в проекте процесс review; GitHub Docs описывает базовый путь через fork и pull request.
Проверка результата
- Требование описывает поведение игрока или системы.
- Есть позитивный и негативный сценарии.
- Область изменения и исключения записаны.
- Агент прочитал актуальные инструкции и существующую реализацию.
- Проверки соответствуют поведению, а не только структуре кода.
- Отчёт отделяет выполненные проверки от предположений.
- Изменение можно понять и продолжить без истории чата.
Задание для ИИ-агента
Прочитай инструкции проекта, статус Git и реализацию рывка с дверями. Сначала сформулируй сценарии и границы изменения. Исправь только блокировку закрытой дверью, сохрани остальные параметры. Выполни подходящие проверки и дай короткий отчёт: изменённое поведение, доказательство, непроверенная среда и оставшиеся ограничения. Не трогай чужие изменения.