6.3 KiB
Raw Blame History

🤖 Gemini CLI: Руководство по эффективной работе

Эта заметка содержит рекомендации по настройке и использованию Gemini CLI в Obsidian Vault для максимальной производительности.

🛠 Конфигурационные файлы проекта

Для того чтобы я работал быстро и соблюдал ваши стандарты, в корне проекта должны быть следующие файлы:

1. GEMINI.md (Персональный устав)

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

  • Для чего: Хранит правила форматирования, структуру папок, стилистику тегов и правила именования файлов.
  • Польза: Избавляет вас от необходимости каждый раз объяснять, что «даты должны быть в формате DD.MM.YYYY».

2. CLAUDE.md (Общие правила)

Если вы используете Claude или другие AI-инструменты, этот файл служит мостом между нами.

  • Для чего: Описание структуры проекта и общих соглашений, принятых в команде/проекте.
  • Польза: Я читаю его, чтобы не конфликтовать с другими ассистентами.

3. .geminiignore (Оптимизация контекста)

Аналог .gitignore, но для меня.

  • Для чего: Исключение из моего «поля зрения» медиа-файлов (_assets/), папок настроек (.obsidian/) и временных файлов.
  • Польза: Критически ускоряет поиск по базе и экономит токены, не давая мне «читать» картинки и бинарные файлы.

👥 Субагенты и их специализация

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

Агент Когда вызывать Что делает
codebase_investigator "Проверь структуру заметок" Глубоко анализирует зависимости, ищет пробелы в знаниях и архитектурные ошибки.
generalist "Обнови поле 'Оценка' во всех книгах" Идеален для массовых операций (Batch processing) и выполнения монотонных задач.
cli_help "Как использовать команду /bug?" Отвечает на вопросы по самому инструменту Gemini CLI.

🧩 Навыки (Skills) и Плагины

Навыки — это мои «прошивки» для специфических действий.

  • Локальные навыки (.claude/skills/): Я могу использовать ваши кастомные навыки (например, add-book, add-course). Чтобы я их применил, просто скажите: "Используй навык add-book".
  • MCP (Model Context Protocol): Я поддерживаю подключение внешних инструментов. Если у вас настроены MCP-серверы, я могу напрямую взаимодействовать с вашей файловой системой, базами данных или сторонними API.
  • Skill Creator: Вы можете попросить меня: "Создай навык для импорта заметок из Telegram", и я сгенерирую новый файл навыка, который смогу использовать в будущем.

Функции (Tools) для Obsidian

Вот список моих «рук», которыми я работаю в вашем Vault:

  1. grep_search: Молниеносный поиск текста внутри заметок (с поддержкой регулярных выражений).
  2. glob: Поиск файлов по шаблону (например, **/Алгоритмы/*.md).
  3. replace: Хирургическое редактирование части заметки без перезаписи всего файла.
  4. write_file: Создание новых заметок или полная перезапись существующих.
  5. run_shell_command: Выполнение команд терминала (git, curl, скрипты на python/js).
  6. web_fetch / google_web_search: Доступ в интернет для поиска информации о книгах, технологиях и новостях IT.

💡 Лайфхаки для работы с Gemini CLI

  • Параллелизм: Я могу выполнять несколько поисков одновременно. Просите меня: "Найди все книги 2024 года И проверь наличие заметок по Python".
  • Plan Mode: Для больших задач (например, реструктуризация всей папки IT/) просите меня: "Зайди в Plan Mode". Я сначала составлю план, вы его утвердите, и только потом я начну вносить изменения.
  • Validation: Всегда просите меня проверить результат: "Добавь книгу и проверь, не битая ли обложка".
  • Git: Я умею делать красивые коммиты. Просто скажите: "Закоммить изменения", и я сам составлю сообщение на основе того, что сделал.

Последнее обновление: 11.03.2026 Теги: #ai #gemini #cli #инструкция #настройка