Проблемы в работе агента
Симптомы
- агент останавливается до завершения задачи;
- придумывает файлы или поведение, которых нет в проекте;
- путается в большом проекте;
- возвращается к отменённой задаче;
- делает лишние изменения или добавляет ненужные комментарии;
- плохо решает повторяющуюся задачу.
Что проверить
- Есть ли в запросе конкретный результат и способ его проверить.
- Приложены ли нужные файлы через
@file,#fileили выделение в редакторе. - Не продолжается ли работа в старом чате с другой задачей.
- Подходит ли выбранный режим агента.
- Есть ли у агента доступ к нужным инструментам и не мешают ли противоречащие Rules или Skills.
Решение
Агент не доводит задачу до конца
Разделите большую работу на подзадачи. Сначала подготовьте план в режиме Plan, затем выполняйте шаги по одному в новом чате. Для каждого шага укажите критерий готовности, например прохождение определённого набора тестов.
Чтобы тесты не были подогнаны под реализацию, запретите их изменение через .writeignore или ограничьте область через Edit Scope.
Агент додумывает факты
Приложите точку входа и попросите указывать файл и символ для каждого вывода. Для незнакомого проекта пройдите онбординг или добавьте постоянный контекст в AGENTS.md.
Агент вернулся к старой задаче
Создайте новый чат через + New Chat. Не продолжайте несвязанную работу в истории отменённой задачи.
Агент делает лишнее
Сформулируйте границы в запросе и задайте технические ограничения через Edit Scope и Tools. Повторяемое требование оформите как Rule, например: «Не добавляй комментарии, если я не попросил об этом».
Агент плохо решает повторяющийся тип задач
Создайте Skill с проверенным порядком действий и критериями результата.