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