Nikolay-ShirokovInstall Erf Build
Pick your agent. Every command is ready to paste.
npx skills add Nikolay-Shirokov/cc-1c-skills --skill erf-buildThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads erf-build when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the erf-build skill”. In Codex, type $erf-build.
/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"
Tips for Erf Build
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Erf Build
What does the Erf Build skill do?
Собрать внешний отчёт 1С (ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать отчёт или получить ERF файл из исходников
How do I install Erf Build?
Run "npx skills add Nikolay-Shirokov/cc-1c-skills --skill erf-build" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Erf Build work in Cursor and Codex?
Yes. Erf Build uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Erf Build free?
Erf Build is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Erf Build?
Erf Build is published by Nikolay-Shirokov in the Nikolay-Shirokov/cc-1c-skills repository, together with 29 other skills.
