Настройка инструментов

Настройкой занимается сам ассистент. Ваша часть невелика: установить ИИ-клиент, скачать архив с навыками и передать ассистенту инструкцию. Остальное — разложить навыки, проверить средства сборки и отладки, найти установленную CAM систему — ассистент делает сам и докладывает о результате. Без вас не обойдутся только разрешения и действия в окнах программ: разрешение установить недостающие программы; перезапуск ИИ-клиента, если он нужен; в CAM системе или NC Тюнере — создание интерпретатора в окне Создать интерпретатор УП, кнопка Задать путь к файлу СПРУТКАМ в этом окне (в NC Тюнере на кнопке — его название), после неё — выход из сеанса Windows и вход заново, и включение журнала в окне Системные настройки. О каждом из этих действий ассистент скажет сам, когда до него дойдёт очередь.

1. Установите ИИ-клиент

Удобнее всего работать в Visual Studio Code: в нём же интерпретатор собирается и отлаживается (см. Отладка интерпретатора в Visual Studio Code). Чат — такое же расширение, как и остальные: откройте панель Extensions (Ctrl+Shift+X), найдите нужное по названию и установите. Подойдёт любой клиент, которому можно разрешить читать и править файлы рабочей папки и запускать в ней команды, — например, Kilo Code или Claude Code; клиент, работающий в терминале, устанавливается своим способом.

Понадобится учётная запись у поставщика ИИ-услуг — см. во что это обходится.

Для интерпретатора на C# понадобятся также Visual Studio Code с расширением C# от Microsoft и .NET SDK той версии .NET, на которой работает ваша версия продукта (см. Версии продукта). Устанавливать их заранее не обязательно: на шаге 3 ассистент проверит, чего не хватает, и предложит установить недостающее — с вашего разрешения.

2. Скачайте навыки

Скачайте архив документации и распакуйте его. Всё содержимое архива лежит в корневой папке public-docs, навыки — в ней в папке src/ai-assisted-development/skills/: шесть папок, в каждой файл SKILL.md.

3. Передайте это ассистенту

Откройте в Visual Studio Code рабочую папку (см. организацию рабочего пространства), откройте чат, разрешите ему выполнять команды в рабочей папке и поставьте задачу. Навыки копируются в папку пользователя (%USERPROFILE%), то есть вне рабочей папки, поэтому клиент спросит разрешение и на это. Поправьте пути (<архив> — полный путь к папке public-docs из распакованного архива) и вставьте:

Настрой инструменты для разработки интерпретаторов по инструкции
<архив>\src\ai-assisted-development\advanced-setup.md
(та же страница на сайте: https://docs.sprut.ru/technical/Interpreters/3/ru/src/ai-assisted-development/advanced-setup.html)

Распакованный архив документации: <архив>
CAM система или NC Тюнер установлены в: <папка установки>

Скопируй все навыки из архива в папку навыков этого клиента
для пользователя, а не для рабочей папки,
проверь .NET SDK и Visual Studio Code с расширением C#;
чего не хватает — назови и предложи установить.
Затем скажи, что именно изменил и какие навыки теперь видишь.

Новые навыки клиенты подхватывают по-разному: Claude Code — сразу (если папки навыков до этого не было — после команды /reload-skills), Kilo Code — в новой сессии или после команды /reload, другие клиенты — по своей документации. Если клиенту нужен перезапуск, ассистент скажет об этом: сделать это за вас он не сможет.

4. Проверьте, что всё получилось

Две просьбы в чат — этого достаточно. Обе безопасны: ассистент только читает и ничего не изменяет.

Проверка навыков. Напишите:

Какие навыки для разработки интерпретаторов ты сейчас видишь и с какого начнёшь работу?

Хороший ответ перечисляет шесть навыков по именам папок и называет interpreter-development первым. Если ассистент рассуждает о «типичных» навыках или просит прислать файлы, навыки не подключились — вернитесь к шагу 3 или к расширенной настройке.

Проверка чтения программ. Положите в папку programs рабочей папки одну-две настоящие УП и напишите:

Прочитай УП в папке programs и перечисли, какие слова и в каком написании в них встречаются. Ничего не меняй.

Хороший ответ — перечень слов из ваших файлов: адреса, G- и M-функции, написания осей вроде B90 и B1=90. Если в ответе слова, которых в программах нет, ассистент рассуждает по памяти: укажите ему файлы явно.

5. Обновления

Навыки обновляются вместе с документацией. Когда выйдет новая версия, скачайте архив заново и попросите ассистента заменить папки навыков целиком.

Если что-то не работает

В устранении проблем собраны типичные симптомы. В расширенной настройке вся процедура подробно — та самая страница, которую вы передали ассистенту, так что любой шаг можно выполнить руками и проверить, что он сделал.