Gemini CLI: как начать с проверки проекта и сохранить контроль над изменениями
Практическая статья об AI-инструменте Gemini CLI: границы проекта, GEMINI.md, первое проверяемое задание и оценка изменений.
Для первого задания уже настроенному Gemini CLI выберите небольшой участок проекта. Например, попросите объяснить обработку ошибок в одной функции и указать связанные проверки. Такой результат легко сопоставить с исходниками до разрешения правок.
Проверьте границу рабочего каталога
В Gemini CLI предусмотрено доверие к папкам. Оно влияет на загрузку настроек проекта и подключение связанных возможностей. В недоверенной папке клиент ограничивает работу с локальными настройками, расширениями и MCP-серверами. Документация Trusted Folders.
Посмотрите состояние security.folderTrust.enabled в своей версии. При подтверждении доверия обратите внимание, выбран текущий каталог или его родитель. Доверие родителю охватывает его подкаталоги, поэтому решение должно соответствовать вашей организации проектов.
Для незнакомого репозитория сначала просмотрите его настройки и инструкции. Не переносите согласие с одного небольшого проекта на общую папку с любыми скачанными репозиториями.
Дайте агенту короткие правила
Gemini CLI использует GEMINI.md для инструкций. Контекст может приходить из пользовательской папки, рабочего пространства и каталогов, к которым обращается инструмент. Посмотреть объединённый контекст позволяет /memory show. Документация GEMINI.md.
Ниже пример текста для проекта. Его нужно адаптировать к своему процессу:
# Работа с проектом
Сначала прочитай участок кода, относящийся к задаче.
Сохраняй посторонние изменения.
Не читай файлы с ключами и паролями.
Для обзора возвращай выводы с путями и строками.
Правки делай только в названных файлах.
Перед изменением зависимостей сообщи причину.
После правок укажи выполненные проверки и их результат.
Текст задаёт порядок работы. Ограничения доступа и подтверждения действий следует проверять также в настройках клиента и подключённых инструментов.
Первое задание сделайте проверяемым
Пример запроса для анализа:
Изучи обработку ошибок в файле [путь].
Не меняй файлы и не запускай команды.
Опиши входные данные, возможные ошибки и существующие тесты.
Для каждого вывода дай путь и строку.
Если связанный файл не прочитан, укажи это.
Проверьте несколько ссылок вручную. Агент должен различать то, что написано в коде, и собственную гипотезу о возможной ошибке.
Следующее поручение можно ограничить одним исправлением и существующим способом проверки. Заранее назовите разрешённые файлы и условие готовности. Отдельно решите, нужны ли коммит, отправка в удалённый репозиторий и выпуск приложения.
Смотрите на результат работы
После изменения сравните исходный запрос с diff. Неожиданное форматирование всего файла, новый пакет или правка соседнего модуля требуют объяснения. В отчёте должны быть названы выполненные проверки; фраза «должно работать» не подтверждает запуск тестов.
Если сравниваете Gemini CLI с другим помощником, используйте одинаковое исходное состояние проекта и одну задачу. Запишите версию клиента, выбранную модель и разрешённые инструменты. Такой разбор можно дополнить инструкциями AGENTS.md и CLAUDE.md и материалом о promptfoo для отдельных проверок AI-ответов.