Skip to main content

Типичные проблемы и методы их решения

Агент работает нестабильно, не решает задачу до конца​

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

  • Разделите задачу на подзадачи:
    1. Перейдите в режим Plan и дайте свою задачу для декомпозиции задачи на подзадачи
    2. Создайте новый чат
    3. Попросите агента в режиме Agent решать подзадачи на основе полученного PLAN.md
  • Feedback loop: опишите агенту критерии остановки явно
    • Например, "делай, пока не пройдут все тесты из папки e2e"
    • Чтобы агент не "хакал" критерий остановки (не подгонял тесты под свой код), вы можете запретить ему менять определённые файлы, внеся их в .writeignore
  • Добавьте новый рул, например, "Всегда проверяй решение, запуская компиляцию проекта"
  • Если работаете с фронтендом (пишете его или тестируете), подключите Chrome MCP или PlayWright MCP в MCP меню плагина, агент сможет "видеть" получаемый UI и станет работать лучше

Агент придумывает то, чего нет в проекте (галлюцинирует)​

Явно указывайте агенту файлы, на которые он должен смотреть, через @file или #file

Агент путается в проекте​

Создайте AGENTS.md: в новом чате вызовите #workflow:init.md

Агент переключился на предыдущую отмененную задачу и начал вносить правки​

Начинайте новую задачу в новом чате: для этого нажмите на + New Chat в правом верхнем углу чата

Агент слишком проактивен, оверинженерит, делает то, о чём вы не просили​

Создайте новое правило, как написано здесь, и напишите в нём:

Не будь проактивным, не оверинженирь, т.е. не делай то, о чём тебя прямо не попросили, например, не дописывай тесты, когда тебя просят писать только код

Агент генерирует слишком много комментариев в коде​

Создайте новое правило, как написано здесь, и напишите в нём:

Не пиши комментарии, если тебя не попросили напрямую

Плагин останавливается с ошибкой вида "This model's maximum context length is X"​

  • Обновите плагин до версии как минимум 5.4.0
  • Вызовите сжатие чата вручную, поставьте галочку, чтобы оно вызывалось автоматически в будущем

Агент не может читать данные из моей базы знаний​

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

Агент плохо решает конкретную задачу​

Чтобы один раз описать подход и применять его снова, создайте Skill с пошаговой инструкцией.

Я попросил править только один файл, а агент поправил ещё другие​

Чтобы сфокусировать правки, настройте Edit Scope и оставьте в нём только нужные файлы.

Тяжело постоянно делать ревью сгенерированного кода​

Чтобы автоматически найти проблемы в сгенерированном коде, запустите Auto Review и примените рекомендации.

Непонятно, как изменить небольшой фрагмент кода в редакторе​

Чтобы быстро вставить код без переписывания файла, используйте генерацию кода в строке редактора.

Непонятно, как связать работу агента с задачами в TMS​

Чтобы подтянуть задачи и статусы, подключите поддержку TMS систем.

Агент не может написать юнит-тесты​

Если агент не может написать юнит тесты, ваш код может быть слишком сложным для этого. Тогда можно сгенерировать юнит тесты на основе e2e тестов, как описано здесь.

Тестовое покрытие низкое​

Чтобы закрыть непокрытые ветки, включите увеличение тестового покрытия и укажите цель.

Тесты нестабильны и периодически падают​

Чтобы найти источник моргающих тестов, запустите анализ теста на моргание (flaky).

Непонятно, как найти информацию в интернете или проверить внешний источник​

Чтобы агент мог искать в интернете и читать сайты, включите Web search & Web fetch.

Непонятно, как сгенерировать сообщение коммита​

Чтобы автоматически описать изменения, используйте генерацию сообщений коммитов прямо из окна коммита в IDE.

Нужно уточнить конкретный фрагмент ответа агента​

Чтобы быстро задать вопрос по конкретному куску ответа, выделите текст и используйте кнопки Ask/Copy.

Плагин показывает некорректный размер контекста для OpenAI-совместимой модели​

Укажите размер контекста вручную в настройках плагина.

Несколько идей подряд, пока агент ещё работает​

Используйте очередь сообщений в чате, чтобы отправлять уточнения и дополнительные инструкции, не дожидаясь завершения текущего ответа.

В чём разница между Rules, Skills, Workflows, Agent modes, AGENTS.md​

СущностьНазначениеПримечаниеПример
AGENTS.mdКонтекст проектаПрименяются ко всем чатам в проекте."Контекст проекта"
RulesНастройка глобального поведенияПрименяются ко всем чатам пользователя."Пиши кратко"
SkillsИнструкции для конкретных задачИспользуются агентами"Сгенерируй тесты"
WorkflowsИнструкции для конкретных задачБудут заменены на Skills."Сгенерируй тесты"
AgentsСпециалист в областиНабор инструментов и доступных Skills в области задач."Техписатель"