server-manager/GEMINI_SKILL_SETUP.md

Развёртывание 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 так:

$HOME/.server-connections/gemini-ssh --list

Далее:

• определить Type
• выбрать команду строго по типу
• выполнить ровно одно действие
• не раскрывать IP, логины, пароли, порты

Рекомендуемая установка

Через GUI

Вкладка Setup теперь умеет ставить:

• Claude skill
• Codex skill
• Gemini skill
• shared backend и wrappers

Через Python installer

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 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

gemini skills list

2. Проверить wrapper

$HOME/.server-connections/gemini-ssh --list

3. Проверить doctor script

$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.