/erf-build — Сборка отчёта
SkillFiles & storageBuild a 1C external report (ERF) from XML sources. Use when the user asks to build or compile a report, or to produce an ERF file from sources.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the /erf-build — Сборка отчёта skill
What this skill tells your AI
The instructions your AI receives, as published by nikolay-shirokov/cc-1c-skills in .claude/skills/erf-build/SKILL.md and read by ahel’s review.
Usage
/erf-build <ReportName> [SrcDir] [OutDir]
| Параметр | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| ReportName | да | — | Имя отчёта (имя корневого XML) |
| SrcDir | нет | src | Каталог исходников |
| OutDir | нет | build | Каталог для результата |
Параметры подключения (опционально)
Предпочтительно использовать конкретную базу — это надёжнее. Временная база всё равно поднимается под проверку исходников, если она не отключена.
- Прочитай
.v8-project.jsonиз корня проекта. Возьмиv8pathи разреши базу: - Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
default - Если
.v8-project.jsonнет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для ERF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
Если v8path не задан — скрипт сам попытается определить платформу (.v8-project.json → Program Files).
Если использованная база не зарегистрирована — после выполнения предложи добавить через /db-list add.
Команда
Используй общий скрипт из epf-build:
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Имя пользователя |
-Password <пароль> | нет | Пароль |
-SourceFile <путь> | да | Путь к корневому XML-файлу исходников |
-OutputFile <путь> | да | Путь к выходному ERF-файлу |
-Checks <список> | нет | Что проверить перед сборкой: modules, handlers, unreferenced, empty-handlers, config; off — не проверять. По умолчанию modules,handlers |
-Context <список> | нет | Контексты проверки modules: ThinClient, Server, ExternalConnection, ThickClientOrdinaryApplication. По умолчанию ThinClient,Server |
-AdditionalV8Arguments <список> | нет | Доп. аргументы запуска 1cv8.exe через запятую, напр. /UseHwLicenses+ |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
Проверка перед сборкой
Перед сборкой исходники проверяет платформа — синтаксис модулей и наличие обработчиков форм.
Если она нашла проблемы, сборка отменяется и файл не создаётся; в выводе — сообщение
платформы со строкой и колонкой и путь к файлу исходника. Отключается -Checks off
или ключом "externalCheck": false в .v8-project.json.
Проверка идёт на отдельной временной базе, даже если база указана: чужую конфигурацию навык не трогает.
Примеры
# Сборка отчёта (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
Signals
- GitHub stars
- 592
- Forks
- 109
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
erf-build- Source
- github.com/nikolay-shirokov/cc-1c-skills