Скіл автоналаштування

Навіщо він потрібен

Скіл setup-dev-manager — це файл SKILL.md з інструкціями для AI-агента, як автоматично налаштувати SnakeFlow. Він лежить у репозиторії SnakeFlow за шляхом .cursor/skills/setup-dev-manager/SKILL.md.

Коли ви просите налаштувати розширення, агент за скілом:

1. Сканує проєкт — lockfile, package.json, Docker Compose, ORM, скрипти, монорепо
2. Підбирає значення — package manager, команди dev-серверів, порти, шляхи до compose
3. Записує налаштування у .vscode/settings.json — усі ключі devManager.* (сервери, Quality Hub, контейнери, БД, за потреби хмара)

Типові сценарії: новий комп’ютер, перший клон репозиторію, швидкий онбординг без ручного копіювання JSON.

---

Як встановити

Cursor

Cursor шукає скіли у глобальній або проєктній директорії всередині .cursor/.

Глобальне встановлення (доступний у будь-якому воркспейсі):

1. Скопіюйте папку з репозиторію SnakeFlow: dev-environment-manager/.cursor/skills/setup-dev-manager/

2. Вставте в каталог скілів Cursor:

   ОС	Шлях
   Windows	%USERPROFILE%\.cursor\skills\setup-dev-manager\
   macOS / Linux	~/.cursor/skills/setup-dev-manager/

3. Переконайтеся, що є файл: .../setup-dev-manager/SKILL.md

4. Перезавантажте Cursor (Ctrl+Shift+P → Developer: Reload Window).

Встановлення в один проєкт: скопіюйте папку до <ваш-проєкт>/.cursor/skills/setup-dev-manager/ і закомітьте — команда отримає скіл при клонуванні.

Antigravity

Antigravity використовує .vscode/ замість .cursor/. Скіл слід покласти у .vscode/skills/.

Глобальне встановлення (доступний у будь-якому воркспейсі):

1. Скопіюйте папку з вашого клону SnakeFlow:
   dev-environment-manager/.cursor/skills/setup-dev-manager/

2. Вставте в каталог скілів Antigravity:

   ОС	Шлях
   Windows	%USERPROFILE%\.vscode\skills\setup-dev-manager\
   macOS / Linux	~/.vscode/skills/setup-dev-manager/

3. Переконайтеся, що є файл: .../setup-dev-manager/SKILL.md

4. Перезавантажте Antigravity (Ctrl+Shift+P → Developer: Reload Window).

Встановлення в один проєкт: скопіюйте папку до <ваш-проєкт>/.vscode/skills/setup-dev-manager/.

VS Code

У звичайному VS Code нативної системи скілів немає, але можна використати скіл вручну з будь-яким AI-чатом (GitHub Copilot Chat, Continue тощо):

1. Відкрийте .cursor/skills/setup-dev-manager/SKILL.md з репозиторію SnakeFlow.
2. Скопіюйте вміст і вставте на початку розмови з AI.
3. Попросіть налаштувати SnakeFlow для вашого проєкту.

Агент виконає ті самі інструкції й запише .vscode/settings.json.

Розгортання skill з розширення (одна команда)

Якщо SnakeFlow уже встановлено, можна скопіювати шаблон setup-dev-manager у поточний workspace без ручного копіювання папок:

1. Палітра команд → SnakeFlow: Deploy AI Skill to Project.
2. Якщо папка skill уже є — підтвердіть перезапис або скасуйте.
3. Розширення створює SKILL.md у каталозі конфігурації редактора в проєкті (.cursor/skills/setup-dev-manager/ у Cursor або .vscode/skills/setup-dev-manager/ там, де використовується така схема).

За потреби перезавантажте вікно редактора й попросіть AI налаштувати SnakeFlow за skill.

---

Як користуватися

1. Встановіть розширення SnakeFlow (Встановлення).

2. Відкрийте корінь проєкту у своєму IDE.

3. У чаті / агенті сформулюйте задачу, наприклад:

   • «Налаштуй SnakeFlow для цього проєкту»
   • «Проскануй репозиторій і заповни devManager у .vscode/settings.json»
   • «Налаштуй Dev Environment Manager: сервери, Docker, Quality Hub»

Агент підхоплює скіл setup-dev-manager і виконує кроки з SKILL.md: аналізує файли, потім пропонує або одразу застосовує зміни до .vscode/settings.json.

Обережно

Перед комітом перегляньте згенерований JSON — порти та команди інколи треба підправити вручну.

---

Інші скіли в репозиторії

Скіл	Призначення
setup-dev-manager	Автоналаштування проєкту → .vscode/settings.json
rebuild-extension	Збірка та пакування розширення з коду (для контриб’юторів)

Обидва скіли розташовані в .cursor/skills/ у кореневій директорії репозиторію SnakeFlow.