Gemini CLI GEMINI.md Учебное руководство по проверке контекста

Итог

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

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

Это упражнение даёт отдельную проверку для каждого вопроса. Вы создадите один синтетический файл инструкций, просмотрите его в командной строке (CLI), измените маркер и ознакомитесь с кратким ответом.

Источники проверены 23 октября 2026 года. Это лаборатория с документационным сопровождением. Здесь мы не запускали аутентифицированную сессию Gemini CLI; ожидаемые проверки ниже являются критериями приёмки, а не результатами модели. Вам нужны Bash, Git, установленный Gemini CLI и настроенная аутентификация. Проверьте данные вашего аккаунта и условия оплаты перед отправкой материала; используйте только приведённый ниже синтетический ввод.

Создайте один контекстный файл, который вы сможете распознать

Официальный Руководство GEMINI.md описывает повторно используемые инструкции, загружаемые из глобальных и рабочих местоположений, при этом более конкретный контекст можно обнаружить во время доступа к инструменту. Это означает, что файл проекта может сосуществовать с другими инструкциями. В нашей лаборатории избегают вложенных файлов, чтобы первая проверка оставалась небольшой.

Выполняйте эти команды оболочки вне ваших рабочих репозиториев. mktemp создает новую директорию; сохраните её напечатанный путь для последующего просмотра.

lab_dir=$(mktemp -d /tmp/gemini-context-lab.XXXXXX)
cd "$lab_dir"
пвд
git init -q
gemini --version > cli-version.txt
кот > GEMINI.md <<'CONTEXT'
# Лаборатория по инспекции синтетического контекста

Маркер контекста: paper-crane-v1

Для ответа лаборатории:
- Начните с активного маркера контекста на отдельной строке.
- Затем предоставьте ровно два пункта списка.
- Используйте только синтетические факты из сообщения пользователя.
- Не редактируйте файлы и не выполняйте команды оболочки для этого ответа.
КОНТЕКСТ
кот GEMINI.md
gemini

Сохраняйте включёнными обычные запросы на одобрение. Инструкция против выполнения инструментов выражает рамки задачи; это не механизм контроля доступа. Отклоняйте любые неожиданные запросы на использование инструментов. Не размещайте учетные данные или данные приватного проекта в этом файле.

Осмотрите перед тем, как запрашивать ответ

Внутри интерактивного CLI введите:

/memory show

С справочник команд документируйте это как вид объединённых загруженных инструкций. Ищите в отображённом тексте paper-crane-v1 и правило с двумя пунктами. Запишите соответствующий фрагмент локально. Избегайте публикации полного вывода: несвязанные глобальные инструкции могут содержать приватные данные.

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

Теперь отправьте:

Синтетические факты: Пример проекта называется Lantern. Его день обзора — пятница.
Суммируйте эти факты, используя формат ответа лаборатории. Инструменты не использовать.

Проверьте ответ по этому контрольному списку, написанному человеком:

Первая строка — paper-crane-v1.
Следуют ровно два пункта.
В ответе сохраняются Lantern и Friday без добавления людей, сроков или утверждений.
Выполнение инструментов или изменение файлов не запрашивалось и не выполнялось.

Прохождение этого примера показывает соответствие на одном простом вводе. Это не устанавливает надежность для всех кодировочных задач.

Измените маркер, пока сессия остаётся открытой

В другом терминале откройте напечатанный путь к каталогу черновиков и редактируйте только GEMINI.md: замените paper-crane-v1 с paper-crane-v2. Сохраните его. Не просите агента сделать это изменение; вы хотите независимую правку для теста перезагрузки.

Вернитесь в ту же сессию CLI Gemini:

/memory reload
/memory show

С context guide documents reload. Справочник по командам также документирует refresh; официальные страницы отличаются в именовании. Если ваша установленная версия отклоняет reload, проверьте /help и используйте /memory refresh если поддерживается. Сохраняйте версию и команду, которая сработала, в своих заметках.

Проверьте, что загруженный блок инструкций теперь содержит paper-crane-v2 и больше не содержит paper-crane-v1. Повторите синтетический запрос. Ответ теперь должен начинаться с v2 и сохранять формат с двумя пунктами. Ответ, который повторяет v1, не проходит эту проверку, даже если его фактическое содержание верно.

Предыдущие сообщения в разговоре все еще могут упоминать v1. Проверяйте загруженный блок инструкций отдельно от истории чата. Если это различие остается неясным, начните новую сессию из той же директории и снова проверьте контекст.

Диагностируйте сбойный слой

Наблюдение	Проверка дальше
Ни один маркер не появился	Подтвердите директорию запуска, сохраненное имя файла и фактические настройки контекста.
v1 остается в загруженных инструкциях	Подтвердите, что редактирование было сохранено по правильному пути, затем повторите поддерживаемую команду перезагрузки.
Оба маркера отображаются в загруженных инструкциях	Проверьте файлы контекста или импорты на наличие дубликатов; устраните неоднозначность перед продолжением.
v2 загружается, но ответ использует v1	Зафиксируйте нарушение соответствия; повторите попытку в новой сессии, а не утверждайте, что перезагрузка не удалась.
Вывод добавляет неподдерживаемые факты	Сузьте задачу и проверьте снова; видимость контекста не подтверждает фактическую точность.

С ссылка на конфигурацию раскрывает context.fileName, который может выбирать другое имя файла или несколько имён. Он также документирует ограничения обнаружения и настройки игнорирования. Проверьте эффективные настройки перед переименованием файлов или расширением области обнаружения. Контекстное руководство описывает загрузку по требованию, в то время как страница конфигурации также описывает рекурсивное обнаружение; не предполагается, что каждый вложенный файл загружается при старте на каждой версии.

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

Сохраняйте доказательства небольшими

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

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

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

Официальные заметки источника

Все проверено 23 октября 2026 года:

Предоставьте контекст с файлами GEMINI.md: расположения контекста, проверка и перезагрузка.
Команды CLI: /memory show, обновление имен и интерактивная справка.
Конфигурация Gemini CLI: настраиваемые имена файлов контекста и параметры поиска. Его описание поиска отличается от руководства по контексту, поэтому лабораторные проверки наблюдали загрузку вместо обещанного универсального порядка обхода.

Запустите это в работу

Различайте обнаружение инструкций, перезагрузку и соответствие.

Попробовать

Создайте экспериментальный проект с одним синтетическим маркером контекста и правилом формата ответа.

Докажите, что это сработало

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

Держите в поле зрения

Файл GEMINI.md предоставляет повторно используемые инструкции для Gemini CLI.
Проверьте загруженный текст, прежде чем предполагать, что правило вашего проекта активно.
Проверьте измененный маркер и полученный ответ как отдельные доказательства.

Изучите рабочий процесс: Сравните средства агента и их рабочие границы