1c-batch

Установка

Скопируй папку src/1c-batch из репозитория vladimir-kharin/1c-batch в .claude/skills проекта и создай .1c-devbase.ps1 по образцу assets/.1c-devbase.ps1.example. Файл добавь в .gitignore.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл дает агенту набор PowerShell-скриптов с запасными bat-версиями для командного запуска конфигуратора. Агент собирает внешние обработки и отчеты из XML и разбирает их обратно, загружает и выгружает конфигурацию целиком или частично, работает с расширениями в XML и файлах cf и cfe. Также он открывает базу в режиме предприятия или конфигуратора. Параметры подключения берутся из файла настроек в корне проекта, поэтому агенту не нужно знать пути и пароли.

Для кого. Для 1С-разработчиков, которые хранят исходники в git и хотят, чтобы агент сам собирал и загружал их в базу.

Пример запроса к агенту

Собери обработку из src/epf/ЗагрузкаЦен.xml в build и загрузи изменения расширения в базу разработки

Ограничения

Скрипты рассчитаны на Windows и установленную платформу 1С:Предприятие 8. Файл .1c-devbase.ps1 содержит учетные данные, его нужно сохранить в UTF-8 с BOM и добавить в .gitignore.

Как отключить. Удалите папку 1c-batch из .claude/skills проекта.

Проверка безопасности

• Загружает конфигурации и расширения в информационную базу
• Хранит учетные данные базы в файле проекта

Коротко о README

README коротко объясняет формат Agent Skills и перечисляет операции скилла таблицей. Установка сводится к копированию папки src/1c-batch в каталог навыков проекта. Настройка описана через файл .1c-devbase.ps1 с путем к платформе, сервером или файловой базой и учетными данными. Лицензия MIT.

SKILL.md

---
name: 1c-batch
description: "Пакетные операции с платформой 1С:Предприятие 8 через командный запуск конфигуратора. Сборка/разборка внешних обработок (.epf/.erf) в XML, загрузка/выгрузка конфигураций и расширений (XML и бинарные .cf/.cfe), запуск предприятия и конфигуратора. Используй, когда нужно выполнить операцию над файлами исходников или базой: собрать или разобрать обработку/отчёт, загрузить или выгрузить в XML конфигурацию или расширение, собрать или загрузить файл .cf/.cfe, запустить 1С:Предприятие или конфигуратор. Не для написания и правки кода."
---

# 1c-batch

Пакетные операции с платформой 1С.

## Варианты запуска: PowerShell (предпочтительный) и .bat (дополнительный)

Каждый скрипт существует в двух версиях с одинаковыми именами и параметрами:

| Вариант | Файлы | Статус |
|---|---|---|
| **PowerShell** | `scripts/*.ps1` | **предпочтительный** |
| Командный (cmd) | `scripts/*.bat` | дополнительный (fallback) |

**Почему PowerShell предпочтителен.** `cmd.exe` под `chcp 65001` ненадёжно читает `.bat` в UTF-8 с кириллицей: он «сползает» по границам строк на многобайтных символах, из-за чего настроечный файл может распарситься неверно (переменные подключения окажутся пустыми). Сломается конкретный файл или нет — зависит от его побайтовой раскладки. PowerShell читает UTF-8 нативно и лишён этой проблемы.

Используй `.bat` только если PowerShell недоступен.

### Настроечный файл (.1c-devbase)

- **PowerShell:** `.1c-devbase.ps1` (переменные `$ONEC_PATH`, `$ONEC_SERVER`, `$ONEC_BASE`, `$ONEC_USER`, `$ONEC_PASSWORD`; либо `$ONEC_FILEBASE_PATH`). Шаблон — `assets/.1c-devbase.ps1.example`.
  - **Сохранять в UTF-8 С BOM.** Windows PowerShell 5.1 читает `.ps1` без BOM как ANSI и портит кириллицу (например, имя пользователя «Администратор»).
- **cmd:** `.1c-devbase.bat` (шаблон `assets/.1c-devbase.bat.example`).

Файл кладётся в **корень проекта** (или в подпапку **`tools\`**, чтобы не засорять корень — скрипты ищут оба места) и не коммитится в git.

### Как запускать (из корня проекта)

```bash
# PowerShell (предпочтительно)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .claude/skills/1c-batch/scripts/build-epf.ps1 src/epf/МояОбработка.xml build/МояОбработка.epf

# cmd (дополнительно)
.claude/skills/1c-batch/scripts/build-epf.bat src/epf/МояОбработка.xml build/МояОбработка.epf
```

Похожие