Лабораторная работа 5. Проектное задание
Выполните задание соответствующее номеру вашего варианта из google-таблицы.
Выбор агентного движка
Варианты: Cursor, Codex, Claude code, Opencode. Cursor можно оплачивать по подписке (когда много программируешь, это дешевле), в Opencode можно подключить дешевые китайские модели через Polza.ai без VPN и оплачивать рублями (раньше я пользовался Openrouter, но он хостится на Cloudflare CDN и часто блокируется). На Openrouter.ai в разделе программирование можно посмотреть самые популярные недорогие модели.
Рекомендации по коду
1) Сделайте ваш проект agent-friendly: создайте в корне файл AGENTS.md, в котором напишите агенту ваш тип ОС, особенности билда и запуска проекта на вашем компьютере, особенности запуска тестов, coding guidelines и инструкции по документированию кода. Впоследствии в этот файл нужно вносить изменения и дополнения, если вы видите, что агент что-то не знает и тратит много времени на то, чтобы это понять.
2) Научитесь запускать тесты. Если тесты отсутствуют, создайте несколько разнообразных функциональных тестов. Не бойтесь просить агента запускать в тестах браузер. Он отлично справляется с созданием тестов, которые запускают в докере сервер, открывают заданный URL в браузере, ждут завершения загрузки страницы и XHR-запросов, проверяют наличие на веб-странице определенных элементов и отсутствие ошибок в консоли браузера.
3) Запустите агента в режиме Plan и попросите исследовать подходы к решению вашей задачи, не внося изменений в код. Пусть он предложит вам несколько вариантов и исследует возможные подводные камни выбранного вами.4) Запустите агента в build для реализации выбранного вами варианта решения задачи
5) Сделайте коммит, чтобы иметь возможность вернуться.
6) Поручите агенту запуск тестов новых функций и исправление возникших ошибок. Если агент не справляется, то ему придется помогать: планировать исправления, просить вставить отладочную печать для понимания причин ошибок, дробить исправления на этапы, делая коммиты, чтобы иметь возможность вернуться назад.
Профессиональным подходом является использование SDD (Spec-Driven Development). Для brownfield-разработки больше всего подходит вариант SDD в реализации OpenSpec. Установите OpenSpec в ваш репозиторий и соответствующий плагин для OpenCode. Перезапустите OpenCode и убедитесь, что у вас появился агент OpenSpec-Plan (третий кроме Plan и Build). Сформируйте план внесения изменений, выполняя последовательно команды: /opsx-explore, /opsx-propose, /opsx-apply, /opsx-verify, /opsx-archive.
Защита проекта
Выполненные работы нужно продемонстрировать преподавателю. Во время сдачи проекта нужно:
- рассказать и показать, что было сделано, для улучшения понимания и работы над проектом агентами
- продемонстрировать успешное прохождение исходных тестов проекта (до введения новой функциональности) - ваш агент не должен ломать исходную функциональность проекта
- продемонстрировать новый функционал и его тесты
- ответить на вопросы по коду