agentleFS
Nikolay-ShirokovNikolay-Shirokov/cc-1c-skills/.claude/skills/epf-build/SKILL.md

epf-build

Skill789 starsChanged 6 months agoMITView on GitHub

Собрать внешнюю обработку 1С (EPF/ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать обработку или получить EPF/ERF файл из исходников

The file

Files
SKILL.md

/epf-build — Сборка обработки

Usage

/epf-build <ProcessorName> [SrcDir] [OutDir]
ПараметрОбязательныйПо умолчаниюОписание
ProcessorNameда—Имя обработки (имя корневого XML)
SrcDirнетsrcКаталог исходников
OutDirнетbuildКаталог для результата

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

Предпочтительно использовать конкретную базу: сборка надёжнее, а configSrc базы из .v8-project.json даёт проверке исходников общие модули конфигурации.

  1. Прочитай .v8-project.json из корня проекта и разреши базу:
  2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  3. Если указал базу по имени — ищи по id / alias / name в .v8-project.json
  4. Если не указал — сопоставь текущую ветку Git с databases[].branches
  5. Если ветка не совпала — используй default
  6. Если .v8-project.json нет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для EPF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.

Платформа — v8path найденной записи базы, иначе корневой v8path. Не задан ни там, ни там — -V8Path не передавай. Если использованная база не зарегистрирована — после выполнения предложи добавить через /db-list add.

Команда

powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <параметры>

Параметры скрипта

ПараметрОбязательныйОписание
-V8Path <путь>нетКаталог bin платформы, или полный путь к 1cv8.exe / ibcmd.exe
-InfoBasePath <путь>*Файловая база
-InfoBaseServer <сервер>*Сервер 1С (для серверной базы)
-InfoBaseRef <имя>*Имя базы на сервере
-UserName <имя>нетИмя пользователя
-Password <пароль>нетПароль
-SourceFile <путь>даПуть к корневому XML-файлу исходников
-OutputFile <путь>даПуть к выходному EPF/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}/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"

# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.