bulgakov

Агент в репозитории: рабочая среда и дисциплина

После урока

вы проведёте небольшое изменение от задания до проверяемого diff, сохранив контроль над действиями агента.

Что действительно делает coding agent

Современный агент может искать код, читать файлы, редактировать их, запускать команды и интерпретировать ошибки. Codex CLI работает с локальным репозиторием; Claude Code, Gemini CLI и OpenCode также предоставляют терминальные рабочие процессы. Cursor и GitHub Copilot предлагают агентные возможности в своих средах. Различия стоит оценивать по разрешениям, контексту, инструментам и результатам на ваших задачах. S14, S15, S16, S17, S18, S19, S51

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

Подготовьте безопасное рабочее место

Начинайте с учебного репозитория или отдельной ветки, проверьте текущие изменения и сохраните точку возврата. Не разрешайте агенту стирать чужую незавершённую работу ради чистого состояния. Для параллельных задач можно применять git worktree: рабочие каталоги будут раздельными, но часть состояния Git общая. Это не изоляция сети, секретов, базы данных или запущенных сервисов. S36

Shell
git status --short
git switch -c ai/discount-rule
git diff

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

Ограничьте доступ папкой задачи, учебной базой и нужными командами. Секреты не должны попадать в контекст, логи или ответы. .gitignore исключает отслеживание Git, но не запрещает чтение файла процессом. Даже .cursorignore не является полной защитной границей: документация отдельно предупреждает об инструментах терминала и MCP. Настоящую границу создают права, изоляция и выдача минимальных учётных данных. S17

Пять этапов одной задачи

1. Изучение. Агент читает инструкции, находит место изменения и существующие тесты. Выход — короткое понимание текущего поведения и неизвестных.

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

3. Реализация. Меняется минимально достаточный участок. Массовое переименование, смена зависимостей и форматирование всего проекта не должны случайно смешиваться с исправлением одного правила.

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

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

Цикл работы с кодовым агентом

Результат каждого шага определяет следующий.

  1. ЗаданиеЦель, ограничения, критерии приёмки.
  2. ИсследованиеФайлы, гипотеза, минимальный план.
  3. ИзменениеНебольшой diff и точка возврата.
  4. ПроверкаЗапуск, тесты и наблюдение за интерфейсом.
  5. РевьюКонтракт, логика и оставшиеся вопросы.
  6. Принятый результатДоказательства и понятные ограничения.
Если проверка выявила ошибку, вернитесь к исследованию и уточните гипотезу.

Инструкции проекта

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

В комплекте templates/AGENTS.md.example — пример для учебного проекта. Не переименовывайте его в активный файл без адаптации. Для Claude Code перенесите подходящие правила в принятый клиентом CLAUDE.md; это отдельный механизм, хотя содержание может пересекаться. Навыки для специфических операций рассматриваются в главе 13.

Диагностика вместо случайных правок

Если тест упал, попросите сначала сформулировать гипотезу: что наблюдается, какое требование нарушено, какой эксперимент различит причины. «Исправляй, пока всё зелёное» иногда приводит к ослаблению тестов или удалению проверки. Обсуждение ожидаемого поведения должно быть отделено от желания убрать красный статус.

Пример: после обновления зависимости приложение падает при запуске. До редактирования бизнес-логики проверьте версию интерпретатора, несовместимый импорт и конфигурацию. Агенту полезно дать полный stack trace и минимальный сценарий воспроизведения. Одна последняя строка ошибки часто скрывает причину.

Если результат снова неверный, не отправляйте то же неопределённое «поправь». Покажите конкретное расхождение: вход, фактический результат, ожидаемый результат и основание ожидания. Такой контрпример обычно ценнее новой эмоциональной формулировки.

Независимое ревью и несколько агентов

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

Другая модель не становится статистически независимым проверяющим автоматически. Она может повторить тот же популярный шаблон или прочитать неправильное требование. Сильнее работает проверка другим способом: тест на границе, ручной расчёт, анализ плана запроса, запуск на устройстве. Для параллельного кода назначьте владельца интеграции и итоговой проверки общей сборки.

Практикум: маленькое изменение

Откройте labs/pricing.py, прочитайте спецификацию в главе 06 и попросите агента объяснить реализацию без изменения файлов. Затем в отдельной копии добавьте правило «скидка доступна только участникам программы». Сначала измените контракт и сценарии, затем реализацию. Сравните diff и убедитесь, что отрицательные суммы и неверные типы по-прежнему отклоняются.

Для честной оценки запишите время на постановку, генерацию, проверку и исправление. Сравнивайте его с полным ручным процессом. Число сгенерированных строк не измеряет ценность: удалённые 200 лишних строк могут быть лучшим результатом, чем добавленные 2 000.

Критерий: вы понимаете каждое существенное изменение и можете воспроизвести проверку. В отчёте есть не только «готово», но и границы подтверждённого результата.


Скачать практикумы и рабочие шаблоны.