Skip to main content

Работать с большим или legacy-проектом

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

Подготовьте проект​

  1. Пройдите сценарий «Подготовить Veai к работе с проектом».
  2. Запишите в AGENTS.md только устойчивые сведения: назначение модулей, команды проверки и соглашения команды.
  3. Закройте секреты и ненужные каталоги через .readignore.
  4. Перед изменениями задайте Edit Scope для целевого модуля или набора файлов.
  5. Сверьте активную конфигурацию: режим, модель, Rules, Skills, Memory Bank, разрешения и подключённые инструменты.
  6. Решите, продолжать ли текущую историю или начать отдельный чат. Для длинной работы заранее прочитайте о контексте и сессиях и сжатии чата.

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

Постройте карту нужной области​

Используйте режим Ask и попросите агента исследовать только путь, который относится к задаче:

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

Проверьте найденные объявления и использования через IDE. Если поведение зависит от внешней библиотеки, пройдите сценарий проверки API зависимости, чтобы агент изучил подключённую версию, а не опирался на память.

Чтение кода подключённой зависимости

Для legacy-проекта особенно важно проверять реальные версии внутренних и внешних библиотек.

Разделите изменение на шаги​

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

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

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

Выполняйте и проверяйте по частям​

  1. Ограничьте Edit Scope файлами текущего шага.
  2. Попросите агента внести только согласованное изменение.
  3. Запустите самую узкую подходящую конфигурацию тестов или сборки.
  4. Просмотрите diff в Agent Changes.
  5. Только после успешной проверки переходите к следующему шагу.

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

Критерий готовности​

Работа завершена, когда:

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

Связанные страницы: