erf-build
Собрать внешний отчёт 1С (ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать отчёт или получить ERF файл из исходников
How do I install this agent skill?
npx skills add https://github.com/nikolay-shirokov/cc-1c-skills --skill erf-buildIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates building 1C reports by executing a PowerShell script with various parameters. It handles database credentials via command-line arguments, which is a security risk as passwords may be exposed in process logs or command history. Additionally, the skill processes external configuration and source files, which presents a surface for indirect prompt injection.
- Socketpass
No alerts
- Snykfail
Risk: HIGH · 1 issue
What does this agent skill do?
/erf-build — Сборка отчёта
Usage
/erf-build <ReportName> [SrcDir] [OutDir]
| Параметр | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| ReportName | да | — | Имя отчёта (имя корневого XML) |
| SrcDir | нет | src | Каталог исходников |
| OutDir | нет | build | Каталог для результата |
Параметры подключения (опционально)
Предпочтительно использовать конкретную базу: сборка надёжнее, а configSrc базы из
.v8-project.json даёт проверке исходников общие модули конфигурации.
- Прочитай
.v8-project.jsonиз корня проекта и разреши базу: - Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
default - Если
.v8-project.jsonнет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для ERF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
Платформа — v8path найденной записи базы, иначе корневой v8path. Не задан ни там, ни там — -V8Path не передавай.
Если использованная база не зарегистрирована — после выполнения предложи добавить через /db-list add.
Команда
Используй общий скрипт из epf-build:
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> | нет | Каталог bin платформы, или полный путь к 1cv8.exe / ibcmd.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 |
-ConfigSrc <путь> | нет | Каталог XML-выгрузки конфигурации, в которой будет работать отчёт. По умолчанию — configSrc указанной базы из .v8-project.json |
-AdditionalV8Arguments <список> | нет | Доп. аргументы запуска 1cv8.exe через запятую, напр. /UseHwLicenses+ |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
Проверка перед сборкой
Перед сборкой платформа проверяет исходники: синтаксис модулей и наличие обработчиков форм.
Если есть ошибки, файл не создаётся, а в выводе — сообщение платформы со строкой и колонкой
и путь к файлу исходника. Собрать без проверки — -Checks off.
Если код обращается к общим модулям конфигурации (ОбщегоНазначения, УправлениеПечатью и т.п.),
проверке нужна выгрузка этой конфигурации. По умолчанию берётся configSrc указанной базы из
.v8-project.json; если его нет — передай каталог выгрузки в -ConfigSrc, а если выгрузки нет
совсем — собирай с -Checks off. Код, который вызывает методы глобальных общих модулей без
имени модуля, проверку не пройдёт и с выгрузкой — его тоже собирай с -Checks off.
Примеры
# Сборка отчёта (файловая база)
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"
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nikolay-shirokov/cc-1c-skills/erf-build">View erf-build on skillZs</a>