/erf-build — Сборка отчёта

SkillFiles & storage

Build 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.

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Каталог для результата

Параметры подключения (опционально)

Предпочтительно использовать конкретную базу — это надёжнее. Временная база всё равно поднимается под проверку исходников, если она не отключена.

  1. Прочитай .v8-project.json из корня проекта. Возьми v8path и разреши базу:
  2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  3. Если указал базу по имени — ищи по id / alias / name в .v8-project.json
  4. Если не указал — сопоставь текущую ветку Git с databases[].branches
  5. Если ветка не совпала — используй default
  6. Если .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