Как подключить 1C Skills к Codex и Claude Code

Установка 1C Skills для локального ИИ-агента: клонирование репозитория, зависимости Python, платформа 1С и первая безопасная проверка.

Article

Чтобы Codex или Claude Code работали с 1С по воспроизводимым правилам, подключите 1C Skills как локальный набор instructions. Агент увидит SKILL.md и сможет использовать готовые скрипты вместо свободной генерации XML.

Установка

git clone https://github.com/msrv-tech/skills.git <skills-root>

Укажите полученный каталог в настройках своей среды. Конкретное расположение зависит от агента: важно, чтобы он сканировал вложенные каталоги с SKILL.md.

Для большинства XML-команд нужны Python 3.11+, lxml и PyYAML. На Windows часть сценариев использует PowerShell 5.1+. Для web-test установите Node.js 18+, зависимости и Chromium:

cd <skills-root>/web-test/scripts
npm ci
npx playwright install chromium

Что нужно для операций с базой

Скилы чтения и редактирования XML могут работать без запущенной 1С. Загрузка конфигурации, сборка артефактов и тесты требуют установленную платформу. На Linux укажите точные пути к 1cv8 и ibcmd; если найдено несколько исполняемых файлов, автоматический выбор намеренно не выполняется.

export ONEC_1CV8_PATH=/opt/1cv8/x86_64/<version>/1cv8
export ONEC_IBCMD_PATH=/opt/1cv8/x86_64/<version>/ibcmd

Первая безопасная задача

Не начинайте с изменения рабочей конфигурации. Попросите агента прочитать проект:

Используй cf-info, сделай обзор конфигурации в src и ничего не изменяй. Затем запусти общую валидацию и объясни найденные ошибки.

После этого проверьте команды, выходные файлы и git status. Следующий шаг — небольшое изменение в отдельной ветке с обязательным diff и загрузкой в тестовую базу.

Skills не требуют подписки Gitsell и не подключают ИИ-агента внутри базы. Модель работает в вашей IDE, а набор даёт ей специализированные инструменты для проекта 1С.