Быстрое понимание контекста
Посадите свежего агента на живую задачу, и он почти наверняка
устроит вам экскурсию по проекту: прочитает
pyproject.toml, затем main.py, затем
всё подряд в каталоге, потому что «надо же разобраться». Через
двадцать шагов он только начинает думать о том, о чём его
спросили. Выглядит как основательность, а на деле это тройной
налог: забитый контекст, потраченный бюджет и размытое внимание
модели.
Опытный разработчик так не делает. Он не читает репозиторий с начала, он грепает по симптому, открывает два файла и правит. Ровно этот рефлекс мы сейчас и пропишем агенту: поиск, потом чтение, потом действие. Кода почти не будет - вся правка живёт в системном промпте.
# Agency появятся две новые строки: сначала
grep, потом read только того, что
меняешь, и никакого чтения «на всякий случай». Многофайловые
задачи после этого укладываются в несколько шагов вместо десятков.
Слова, которые встретятся
- grep-first - привычка сначала найти совпадения по проекту, а открывать уже только те файлы, которые в них засветились.
- Политика действия - правила про то, «как работать вообще». Им место в секции Agency, а не в docstring отдельного tool: docstring отвечает за один инструмент, Agency - за манеру работы целиком.
Быстрый путь
- В
prompts.pyдописать два пункта в Agency. - Прогнать задачу без имени файла - должен быть grep раньше read.
- Прогнать задачу с путём к файлу - сразу read.
Какие файлы трогаем
| Файл | Что делать |
|---|---|
prompts.py |
Править. Два буллета в секции Agency. |
| tools / main | Не трогать. Tools те же; меняется только политика. |
Шаг 1. Допишите Agency
Найдите блок # Agency в
build_system_prompt. Добавьте две строки в конец
списка (имена tools у вас уже подставляются):
prompts.py - секция Agency
parts.append(f"""
# Agency
- ПОЛЬЗУЙСЯ инструментами: читай, ищи, запускай - потом отвечай.
- НЕ объясняй, что собираешься сделать. Сделай, потом коротко отчитайся.
- Доступные инструменты: {tools}
- Для поиска - grep, для файла - read; bash - только если без него никак.
- Сначала поиск, потом чтение. Используй grep первым, затем read только
того, что будешь менять или на что опираешься в ответе.
- Не читай файлы «на всякий случай». Читай то, что нужно, когда нужно.
""")
Два буллета - и вся смена политики. Соблазн продублировать то же
самое в docstring grep есть у всех, но не делайте
этого: инструмент отвечает за то, как его вызывать, а порядок
работы задаётся уровнем выше.
Как выглядит на практике
Возьмём живой запрос: «найди, где парсится JSON». Вот как это выглядело до правки промпта - добросовестно и безнадёжно.
read pyproject.toml
read main.py
read prompts.py
read approval.py
read tools_bash.py
... ещё 15 файлов
только потом думать
А вот как теперь:
grep pattern: "json\.(loads|load)|JSONDecodeError"
→ совпадения в файлах A, B
read A
read B
ответ
Пять шагов вместо тридцати, и в контексте лежит ровно то, что нужно для ответа. Приятный побочный эффект: читать лог стало можно глазами, а не по диагонали.
read разом. Хорошо, пусть. Но
выпрашивать это отдельным пунктом промпта не стоит: выигрыш
копеечный, а инструкция лишняя. Один честный grep-first - уже
победа.
grep возвращает
список, а не простыню. Лимит совпадений из модуля 5 (у нас
около 50) тут отрабатывает по-настоящему: модель видит пометку
об обрезке и сама сужает паттерн. Снимите лимит - и grep-first
тихо мутирует обратно в «прочитай полрепозитория», только
другим способом.
Проверьте
Первый прогон - задача без единого имени файла. Тут агент обязан начать с поиска.
uv run python main.py . "Найди все места, где проект парсит JSON, и скажи, какие могут упасть на кривом вводе. Не читай всё подряд."
В логе ожидаем сначала grep (или
task с разведкой), а уже потом read
строго по найденным путям. Никаких «открою-ка main на удачу».
Второй прогон - обратная проверка: путь назван прямо, и искать тут нечего.
uv run python main.py . "Что в файле approval.py? Кратко по содержимому."
Должен пойти сразу read на
approval.py, без ритуального «поищу-ка approval по
всему диску». Политика не про то, чтобы грепать всегда, а про
то, чтобы не читать наугад.
Готово, если:
- В Agency есть два новых буллета про grep-first
- Задача без пути к файлу начинается с поиска
- Задача с путём идёт сразу в read
- На разведке заметно меньше лишних read