1C Skills for AI Agents

Набор curated-скилов для локальной разработки на 1С:Предприятии с ИИ-агентами: Codex, Claude Code и другими средами, которые умеют подключать локальные skills/instructions.

Репозиторий содержит 82 скила для работы с XML-исходниками конфигураций 1С, расширениями, внешними обработками и отчетами, управляемыми формами, СКД, MXL-макетами, ролями, подсистемами, информационными базами, веб-публикацией, HTTP bridge для тестов и браузерными smoke-тестами.

Что Внутри

• Конфигурации: cf-init, cf-info, cf-edit, cf-validate, cf-new-project, cf-add-object
• Расширения: cfe-init, cfe-borrow, cfe-patch-method, cfe-diff, cfe-validate
• Метаданные: meta-compile, meta-edit, meta-info, meta-remove, meta-validate
• Формы, макеты, роли, подсистемы, СКД, MXL, EPF/ERF
• Информационные базы: db-create, db-load-xml, db-dump-xml, db-load-cf, db-dump-cf, db-update, db-run
• Веб-сценарии: публикация через Apache (web-publish), статус/удаление/остановка публикаций, браузерная автоматизация через web-test
• HTTP bridge: codex-test-bridge с исходниками расширения, готовым CFE и Python-клиентом без proxy-переменных
• Справочные и маршрутизирующие скилы: inspect, validate, query-optimization, form-patterns

Полный список см. в SKILLS_TABLE.md или skills-index.csv.

Источники

• Desko77/claude-code-skills-1c
• Nikolay-Shirokov/cc-1c-skills
• RooLee10/web-session

Статьи

• Infostart: 1C Skills для ИИ-агентов — инструменты для разработки, проверки и тестирования 1С
• Markdown-версия статьи

Test Bridge Для 1С

codex-test-bridge — служебное расширение 1С для демо- и тестовых баз. Оно добавляет HTTP API поверх базы и закрывает сценарии, где раньше приходилось использовать COM-подключение или интерактивный UI: быстро проверить доступность базы, получить метаданные, выполнить запрос, создать тестовые данные, записать объект, провести документ или отрендерить внешний отчет/печатную форму.

В каталоге скила лежат:

• src/ — XML-исходники расширения
• codex-test-bridge.cfe — готовое собранное расширение
• client.py — Python-клиент, который отключает proxy-переменные для локальных HTTP-запросов
• scripts/build_cfe_windows.ps1 — сборка CFE через ibcmd.exe
• scripts/enable_vrd_windows.ps1 — включение HTTP-сервиса bridge в default.vrd
• BRIDGE.md — подробная спецификация API и примеры команд

Типовой порядок работы:

# 1. Опубликовать тестовую базу через web-publish
python D:\bsl\skills\web-publish\scripts\web-publish.py `
  -V8Path "C:\Program Files\1cv8\8.3.27.1859\bin" `
  -InfoBasePath D:\bases\demo `
  -AppName demo1c `
  -ApachePath D:\bsl\skills\temp\apache24 `
  -Port 9091

# 2. Включить HTTP-сервис расширения в VRD
powershell.exe -NoProfile -File D:\bsl\skills\codex-test-bridge\scripts\enable_vrd_windows.ps1 `
  -VrdPath D:\bsl\skills\temp\apache24\publish\demo1c\default.vrd

# 3. Проверить bridge
python D:\bsl\skills\codex-test-bridge\client.py `
  --base-url http://127.0.0.1:9091/demo1c/hs/codex-test health

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

Требования

Для базовой локальной проверки нужны:

• ИИ-агент с поддержкой локальных skills/instructions, например Codex или Claude Code
• Python 3.11+ с пакетами lxml и PyYAML
• PowerShell на Windows
• Node.js 18+ для web-test

Для сценариев, завязанных на 1С:

• установленная платформа 1С:Предприятие с 1cv8.exe
• режим Конфигуратора для загрузки, выгрузки и сборки артефактов
• ibcmd.exe для headless-диагностики и проверки generation-id

Для веб-сценариев:

• web-publish управляет portable Apache и использует wsap24.dll
• публикация в IIS в текущих web-* скилах не реализована
• web-test использует Playwright и видимый Chromium

Установка

Склонируйте репозиторий в каталог skills/instructions вашего ИИ-агента или в другой каталог, который сканирует ваша среда:

git clone https://github.com/msrv-tech/skills.git D:\bsl\skills

Для web-test установите Node-зависимости и браузерные бинарники:

cd D:\bsl\skills\web-test\scripts
npm ci
npx playwright install chromium

Использование

Каждый скил находится в отдельном каталоге и содержит файл SKILL.md с правилами срабатывания, параметрами и примерами.

Большинство исполняемых скилов содержит Python- и/или PowerShell-скрипты в папке scripts/. Пример прямого запуска:

python D:\bsl\skills\cf-info\scripts\cf-info.py -ConfigPath D:\project\src -Mode overview

В ИИ-агенте можно формулировать задачу естественным языком, например:

• "Создай справочник Контрагенты с реквизитами ИНН и КПП"
• "Проверь конфигурацию в src"
• "Собери внешнюю обработку из XML"
• "Опубликуй базу в веб-клиенте и прогони smoke-тест"

Статус Проверки

Набор скилов был smoke-tested на Windows с реальными версиями платформы 1С:Предприятие 8.3.25, 8.3.27 и 8.5.1.

Успешно проверено:

• компиляция Python и парсинг PowerShell
• структура SKILL.md, agents/openai.yaml и evals.json
• цепочки конфигураций, расширений, метаданных, форм, MXL, СКД, ролей и подсистем
• создание, загрузка, обновление и выгрузка файловых информационных баз
• загрузка и выгрузка CF
• сборка и разборка EPF/ERF через Конфигуратор
• веб-публикация через Apache
• codex-test-bridge: сборка CFE, установка в демобазу и HTTP smoke через health/metadata
• браузерная автоматизация через web-test на опубликованной демо-базе

Известные границы:

• текущие web-* скилы работают с Apache, не с IIS
• часть справочных и маршрутизирующих скилов является documentation-first и не содержит прямых исполняемых скриптов
• полноценные сценарии для серверных баз и IIS требуют конкретных учетных данных и настроек окружения

Примечания

Временные данные smoke-тестов должны лежать в temp/; этот каталог игнорируется репозиторием.

Скрипты намеренно сделаны локальными и консервативными. Они предпочитают работу с XML-исходниками и явную валидацию, а реальные workflow через Конфигуратор 1С, Apache и Playwright используют только когда окружение доступно.