Формат правки файла определяет, справится ли агент с редактированием

Заставить модель написать код несложно; сложно аккуратно вставить его в существующий файл. Именно здесь агенты ломаются чаще всего: правка не применяется, применяется не туда или затирает соседние строки.

Сложились три подхода. Переписывание файла целиком надёжно применяется, но дорого и опасно на больших файлах. Классический дифф с номерами строк компактен, но модель регулярно ошибается в счёте. Замена по точному фрагменту — компромисс, требующий, чтобы искомый текст был воспроизведён символ в символ.

Отказ лучше приблизительного попадания

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

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

Что это значит

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

Похожие материалы и обновления по теме мы собираем в разделе Инструменты для разработчиков — он пополняется по мере выхода новых сообщений.