Описание
1c-batch — скилл пакетной работы с платформой 1С: сборка и разборка обработок — упаковка и распаковка внешних обработок из исходников, выгрузка и загрузка конфигураций — работа с файлами cf и dt, расширения — те же операции для cfe, запуск базы — старт 1С с параметрами из командной строки. Для разработчиков 1С, автоматизирующих рутину через агента и скрипты.
Что умеет:
— собирать и разбирать обработки;
— выгружать и загружать конфигурации;
— работать с расширениями;
— запускать базы с параметрами.
Полная документация ниже — автоматически из репозитория vladimir-kharin/1c-batch (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.
1c-batch
Навык (Agent Skill) для AI-агентов — автоматизация пакетных операций с платформой 1С:Предприятие 8. Набор PowerShell-скриптов (с запасными bat-версиями) для сборки обработок, управления конфигурацией и расширениями, запуска 1С — всё без ручного вмешательства.
Что такое Agent Skills?
Открытый стандарт расширения AI-агентов (Claude Code, Cursor и др.). Навык загружается в контекст по требованию: агент видит только имя и описание (~100 токенов), а полные инструкции и скрипты подключает когда они нужны.
Что умеет
| Операция | Что делает |
|---|---|
| Сборка обработки | XML → EPF/ERF |
| Разборка обработки | EPF/ERF → XML |
| Загрузка конфигурации | XML → база (полностью или отдельные файлы) |
| Выгрузка конфигурации | база → XML (полная или инкрементальная) |
| Загрузка расширения | XML → база |
| Выгрузка расширения | база → XML |
| Сборка файла конфигурации | база → CF |
| Загрузка файла конфигурации | CF → база |
| Сборка файла расширения | база → CFE |
| Загрузка файла расширения | CFE → база |
| Запуск предприятия | открыть базу в режиме предприятия |
| Запуск конфигуратора | открыть базу в конфигураторе |
Установка
Скопируйте папку src/1c-batch в каталог навыков вашего проекта. Агент с поддержкой Agent Skills обнаружит навык автоматически.
Например, для Claude Code — в .claude/skills/.
Настройка
Создайте в корне проекта (или в подпапке tools\) файл .1c-devbase.ps1 по образцу assets/.1c-devbase.ps1.example:
$ONEC_PATH = "C:\Program Files\1cv8\8.3.24.1467\bin\1cv8.exe"
# Серверная база (приоритет):
$ONEC_SERVER = "server-1c"
$ONEC_BASE = "erp_dev"
# Или файловая база:
# $ONEC_FILEBASE_PATH = "D:\Bases\MyBase"
$ONEC_USER = "Администратор"
$ONEC_PASSWORD = ""
Сохраняйте файл в UTF-8 с BOM (Windows PowerShell 5.1 читает
.ps1без BOM как ANSI и портит кириллицу) и добавьте его в.gitignore— файл содержит учётные данные.
Для запасных bat-скриптов аналогично создаётся .1c-devbase.bat по образцу assets/.1c-devbase.bat.example.
Автор
Владимир Харин — Telegram
Лицензия
MIT License