docs: refresh Claude Codex and Gemini integration guides
This commit is contained in:
86
GEMINI_SKILL_SETUP.md
Normal file
86
GEMINI_SKILL_SETUP.md
Normal file
@@ -0,0 +1,86 @@
|
||||
# Развёртывание Gemini Skill Для ServerManager
|
||||
|
||||
Этот документ описывает, как ServerManager интегрируется с Gemini CLI.
|
||||
|
||||
## Что устанавливается
|
||||
|
||||
Для каждого target home устанавливаются:
|
||||
|
||||
1. Общий backend:
|
||||
- `~/.server-connections/ssh.py`
|
||||
- `~/.server-connections/encryption.py`
|
||||
2. Gemini skill package:
|
||||
- `~/.gemini/skills/server-manager/`
|
||||
3. Безопасный runtime wrapper:
|
||||
- `~/.server-connections/gemini-ssh`
|
||||
4. Глобальный Gemini context:
|
||||
- `~/.gemini/GEMINI.md`
|
||||
|
||||
## Skill workflow
|
||||
|
||||
Gemini должен начинать discovery так:
|
||||
|
||||
```bash
|
||||
$HOME/.server-connections/gemini-ssh --list
|
||||
```
|
||||
|
||||
Далее:
|
||||
|
||||
- определить `Type`
|
||||
- выбрать команду строго по типу
|
||||
- выполнить ровно одно действие
|
||||
- не раскрывать IP, логины, пароли, порты
|
||||
|
||||
## Рекомендуемая установка
|
||||
|
||||
### Через GUI
|
||||
|
||||
Вкладка `Setup` теперь умеет ставить:
|
||||
|
||||
- Claude skill
|
||||
- Codex skill
|
||||
- Gemini skill
|
||||
- shared backend и wrappers
|
||||
|
||||
### Через Python installer
|
||||
|
||||
```bash
|
||||
python3 tools/install_ai_integrations.py
|
||||
python3 tools/install_ai_integrations.py --target-home /root
|
||||
python3 tools/install_ai_integrations.py --all-users
|
||||
```
|
||||
|
||||
### Через shell installer (Linux/macOS)
|
||||
|
||||
```bash
|
||||
bash tools/install.sh --source-dir /path/to/server-manager
|
||||
bash tools/install.sh --source-dir /path/to/server-manager --target-home /root
|
||||
bash tools/install.sh --source-dir /path/to/server-manager --all-users
|
||||
```
|
||||
|
||||
## Проверка
|
||||
|
||||
### 1. Проверить skill discovery
|
||||
|
||||
```bash
|
||||
gemini skills list
|
||||
```
|
||||
|
||||
### 2. Проверить wrapper
|
||||
|
||||
```bash
|
||||
$HOME/.server-connections/gemini-ssh --list
|
||||
```
|
||||
|
||||
### 3. Проверить doctor script
|
||||
|
||||
```bash
|
||||
$HOME/.gemini/skills/server-manager/scripts/server-manager-gemini-doctor.sh
|
||||
```
|
||||
|
||||
## Важные замечания
|
||||
|
||||
- `servers.json` не размножается автоматически в `--all-users` режиме — это сделано намеренно, чтобы не копировать credentials между пользователями.
|
||||
- Для root / service accounts используйте отдельную установку в нужный `target home`.
|
||||
- Gemini skill source в репозитории лежит в `.gemini/skills/server-manager/`.
|
||||
- При необходимости можно дополнительно ставить mirror в `~/.agents/skills/server-manager/`, но по умолчанию это отключено, чтобы Gemini не ругался на duplicate skill conflict.
|
||||
Reference in New Issue
Block a user