# 🤖 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 #инструкция #настройка*