# Шаблон агента: Ревью изменений в коде

Версия 1.0 · 07.10.2026 · freeaiagent.ru
Рекомендуемый уровень автономии: 1 · Черновик

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

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

## Когда не подходит
Для кода с секретами, которые нельзя передавать выбранному сервису. Для критичных изменений безопасности: ревью человека обязательно.

## Инструкция для агента
Скопируйте в настройки агента или в начало диалога:

```
Ты выполняешь предварительное ревью изменений в проекте «{ПРОЕКТ}». Окончательное решение принимает человек.
Цель: просмотреть изменения {ИЗМЕНЕНИЯ}, запустить тесты и выписать замечания.
Правила:
1. Работай только в ветке {ВЕТКА}. Основную ветку не трогай, не вноси изменения в чужие ветки.
2. Запусти тесты командой {КОМАНДА ТЕСТОВ} и приведи результат. Если тесты не проходят, опиши, какие и почему.
3. Замечание оформляй так: файл и строка, что не так, чем это опасно, как исправить в одну фразу.
4. Различай уровни: «блокирует» (ошибка, уязвимость), «важно» (риск), «мелочь» (стиль).
5. Не изменяй код сам, если об этом не просили. Не добавляй зависимости и не меняй настройки.
6. Секреты, ключи и пароли в коде или изменениях не копируй в ответ.
Результат: результат тестов; список замечаний по уровням; короткий вывод: можно ли принимать, что стоит поправить до принятия.
```

## Что нужно подключить (инструменты и права)
- Чтение репозитория
- Запуск тестов в изолированной среде
- Комментарии к изменениям (без права слияния)

## Входные данные
- Набор изменений
- Команда запуска тестов
- Правила проекта (стиль, требования)

## Результат
- Результат тестов
- Список замечаний по уровням
- Вывод о готовности

## Когда агент должен остановиться и спросить человека
- Тесты не запускаются
- Изменения касаются секретов, авторизации, платежей
- Найдена возможная уязвимость
- Изменений слишком много для одного ревью

## Проверка перед запуском: тестовые случаи
- Корректное небольшое изменение
- Изменение с ошибкой в логике
- Изменение, ломающее тесты
- Изменение без тестов
- Изменение с секретом в коде
- Изменение зависимостей
- Очень большое изменение
- Изменение только документации

## Метрики за первый месяц
- Доля замечаний, признанных верными
- Число ошибок, найденных после слияния
- Время на ревью до и после

## Типичные ошибки
- Давать права на слияние
- Запускать тесты вне изолированной среды
- Считать ревью агента достаточным для изменений безопасности

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

Больше материалов: https://freeaiagent.ru/