epf-expert
Skill0 starsChanged 4 months agoMITView on GitHub
Этот скилл MUST быть вызван для всех операций с внешними обработками 1С (EPF): создание (init), сборка (build), разборка (dump), добавление формы (add-form), регистрация в БСП (bsp-init), добавление команды БСП (bsp-add-command). SHOULD также вызывать при любой работе с EPF-файлами и их исходниками. Do NOT использовать для внешних отчётов (ERF) — используй erf-expert; для добавления формы к объекту конфигурации — form-add.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- Arman-Kudaibergenov/1c-ai-development-kitword for word, first seen Mar 4, 2026
Other versions1 project uses a version of this.
Word for word · 1
- Arman-Kudaibergenov/1c-ai-development-kit★ 163100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository55 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- 1c-help-mcpSkill
- 1c-project-initSkill
- 1c-query-optSkill
- 1c-test-runnerSkill
- 1c-web-sessionSkill
- brainstormSkill
- bsp-patternsSkill
- cfe-borrowSkill
- cfe-diffSkill
- cf-editSkill
- cfe-initSkill
- cfe-patch-methodSkill
- cf-initSkill
- db-createSkill
- db-dump-cfSkill
- db-dump-xmlSkill
- db-listSkill
- db-load-cfSkill
- db-load-gitSkill
- db-load-xmlSkill
- db-runSkill
- db-updateSkill
- erf-expertSkill
- form-addSkill
- form-compileSkill
- form-editSkill
- form-patternsSkill
- form-removeSkill
- help-addSkill
- img-gridSkill
- inspectSkill
- meta-compileSkill
- meta-editSkill
- meta-removeSkill
- mxl-expertSkill
- openspec-applySkill
- openspec-archiveSkill
- openspec-proposalSkill
- playwright-testSkill
- role-expertSkill
- session-restoreSkill
- session-retroSkill
- session-saveSkill
- skd-compileSkill
- skd-editSkill
- subagent-devSkill
- subsystem-expertSkill
- validateSkill
- web-infoSkill
- web-publishSkill
- web-stopSkill
- web-testSkill
- web-unpublishSkill
- write-planSkill
The file
Files
/epf-expert — Внешние обработки 1С (EPF)
Единый скилл для всех операций с внешними обработками EPF. Выбери нужный режим:
| Режим | Что делает |
init | Создать новую пустую обработку (scaffold XML) |
build | Собрать EPF из XML-исходников |
dump | Разобрать EPF в XML-исходники |
add-form | Добавить управляемую форму к обработке |
bsp-init | Зарегистрировать обработку в подсистеме БСП |
bsp-add-command | Добавить команду в регистрацию БСП |
Режим: init — создание обработки
Генерирует минимальный набор XML-исходников для внешней обработки (EPF) 1С.
Usage
/epf-expert init <Name> [Synonym] [SrcDir]| Параметр | Обязательный | По умолчанию | Описание |
| Name | да | — | Имя обработки (латиница/кириллица) |
| Synonym | нет | = Name | Синоним (отображаемое имя) |
| SrcDir | нет | src | Каталог исходников относительно CWD |
Команда
powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]Что создаётся
<SrcDir>/
├── <Name>.xml # Корневой файл метаданных (4 UUID)
└── <Name>/
└── Ext/
└── ObjectModule.bsl # Модуль объекта с 3 регионами- Корневой XML содержит
MetaDataObject/ExternalDataProcessorс пустымиDefaultFormиChildObjects - ClassId фиксирован:
c3831ec8-d8d5-4f93-8a22-f9bfae07327f - Файл создаётся в UTF-8 с BOM
Дальнейшие шаги
- Добавить форму:
/epf-expert add-form - Добавить макет:
/mxl-expert template-add - Добавить справку:
/help-add - Собрать EPF:
/epf-expert build
Режим: build — сборка EPF
Собирает EPF файл из XML-исходников с помощью платформы 1С.
Usage
/epf-expert build <Name> [SrcDir] [OutDir]| Параметр | Обязательный | По умолчанию | Описание |
| Name | да | — | Имя объекта (имя корневого XML) |
| SrcDir | нет | src | Каталог исходников |
| OutDir | нет | build | Каталог для результата |
Параметры подключения
Прочитай .v8-project.json из корня проекта. Возьми v8path и разреши базу:
- Если пользователь указал параметры (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи в
.v8-project.json - Если не указал — сопоставь ветку Git с
databases[].branches - Если ветка не совпала — используй
default - Если
.v8-project.jsonнет — создай пустую ИБ в./base
Если v8path не задан: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1
Команда
powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-build.ps1 -InfoBasePath "<путь>" -SourceFile "src\<Name>.xml" -OutputFile "build\<Name>.epf"| Параметр | Обязательный | Описание |
-V8Path <путь> | нет | Каталог bin платформы |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Пользователь |
-Password <пароль> | нет | Пароль |
-SourceFile <путь> | да | Корневой XML исходников |
-OutputFile <путь> | да | Выходной EPF файл |
*— нужен либо-InfoBasePath, либо пара-InfoBaseServer+-InfoBaseRef
Примечание: Если объект использует ссылочные типы конфигурации — сборка в пустой базе упадёт с ошибкой XDTO. Зарегистрируй базу с целевой конфигурацией через /db-list add.
Режим: dump — разборка EPF
Разбирает EPF файл в XML-исходники с помощью платформы 1С (иерархический формат).
Usage
/epf-expert dump <File> [OutDir]| Параметр | Обязательный | По умолчанию | Описание |
| File | да | — | Путь к EPF файлу |
| OutDir | нет | src | Каталог для выгрузки исходников |
Параметры подключения
Аналогично режиму build — разрешение базы через .v8-project.json.
Команда
powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-dump.ps1 -InfoBasePath "<путь>" -InputFile "<файл>.epf" -OutputDir "src"| Параметр | Обязательный | Описание |
-V8Path <путь> | нет | Каталог bin платформы |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Пользователь |
-Password <пароль> | нет | Пароль |
-InputFile <путь> | да | Путь к EPF файлу |
-OutputDir <путь> | да | Каталог для выгрузки |
-Format <формат> | нет | Hierarchical (по умолч.) / Plain |
Структура результата (Hierarchical)
<OutDir>/
├── <Name>.xml
└── <Name>/
├── Ext/
│ └── ObjectModule.bsl
├── Forms/
│ ├── <FormName>.xml
│ └── <FormName>/Ext/Form.xml
└── Templates/
├── <TemplateName>.xml
└── <TemplateName>/Ext/Template.<ext>Режим: add-form — добавление формы
Создаёт управляемую форму и регистрирует её в корневом XML обработки.
Usage
/epf-expert add-form <ProcessorName> <FormName> [Synonym] [--main]| Параметр | Обязательный | По умолчанию | Описание |
| ProcessorName | да | — | Имя обработки (должна существовать) |
| FormName | да | — | Имя формы |
| Synonym | нет | = FormName | Синоним формы |
| --main | нет | авто | Установить как форму по умолчанию |
| SrcDir | нет | src | Каталог исходников |
Команда
powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/add-form.ps1 -ProcessorName "<ProcessorName>" -FormName "<FormName>" [-Synonym "<Synonym>"] [-Main] [-SrcDir "<SrcDir>"]Что создаётся
<SrcDir>/<ProcessorName>/Forms/
├── <FormName>.xml # Метаданные формы (1 UUID)
└── <FormName>/
└── Ext/
├── Form.xml # Описание формы (logform namespace)
└── Form/
└── Module.bsl # BSL-модуль с 5 регионами<SrcDir>/<ProcessorName>.xml— добавляется<Form>вChildObjects, обновляетсяDefaultForm- FormType: Managed; UsePurposes: PlatformApplication, MobilePlatformApplication
- AutoCommandBar с id=-1; Реквизит "Объект" с MainAttribute=true
Режим: bsp-init — регистрация в БСП
Добавляет в модуль объекта обработки функцию СведенияОВнешнейОбработке() для подсистемы БСП.
Usage
/epf-expert bsp-init <ProcessorName> <Вид> [Назначение...]| Параметр | Обязательный | По умолчанию | Описание |
| ProcessorName | да | — | Имя обработки |
| Вид | да | — | Вид обработки (см. маппинг) |
| Назначение | * | — | Объекты для назначаемых видов |
| SrcDir | нет | src | Каталог исходников |
* Обязательно для: ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов.
Маппинг вида обработки
| Пользователь пишет | Вид | API-метод |
| доп обработка, глобальная | ДополнительнаяОбработка | ВидОбработкиДополнительнаяОбработка() |
| доп отчёт, глобальный отчёт | ДополнительныйОтчет | ВидОбработкиДополнительныйОтчет() |
| заполнение | ЗаполнениеОбъекта | ВидОбработкиЗаполнениеОбъекта() |
| отчёт (назначаемый) | Отчет | ВидОбработкиОтчет() |
| печатная форма, печать | ПечатнаяФорма | ВидОбработкиПечатнаяФорма() |
| создание связанных объектов | СозданиеСвязанныхОбъектов | ВидОбработкиСозданиеСвязанныхОбъектов() |
Тип команды по умолчанию
| Вид | ТипКоманды |
| ДополнительнаяОбработка | ТипКомандыОткрытиеФормы() |
| ДополнительныйОтчет | ТипКомандыОткрытиеФормы() |
| ЗаполнениеОбъекта | ТипКомандыВызовСерверногоМетода() |
| Отчет | ТипКомандыОткрытиеФормы() |
| ПечатнаяФорма | ТипКомандыВызовСерверногоМетода() |
| СозданиеСвязанныхОбъектов | ТипКомандыВызовСерверногоМетода() |
Шаблон функции
Функция СведенияОВнешнейОбработке() Экспорт
МетаданныеОбработки = Метаданные();
ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ВидОбработки}};
ПараметрыРегистрации.Версия = "1.0";
{{СЕКЦИЯ_НАЗНАЧЕНИЕ}} // только для назначаемых видов
НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
НоваяКоманда.Представление = МетаданныеОбработки.Представление();
НоваяКоманда.Идентификатор = МетаданныеОбработки.Имя;
НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
НоваяКоманда.ПоказыватьОповещение = Ложь;
{{СЕКЦИЯ_МОДИФИКАТОР}} // только для ПечатнаяФорма: НоваяКоманда.Модификатор = "ПечатьMXL"
Возврат ПараметрыРегистрации;
КонецФункцииИнструкции
- Найди
ObjectModule.bsl:src/{{ProcessorName}}/Ext/ObjectModule.bsl - Если
СведенияОВнешнейОбработкеуже есть — сообщи, не дублируй - Найди область
#Область ПрограммныйИнтерфейси вставь функцию внутрь - Для видов с серверным обработчиком — добавь соответствующую процедуру после функции
- Используй табы для отступов
Режим: bsp-add-command — добавление команды БСП
Добавляет команду в существующую функцию СведенияОВнешнейОбработке(). Предварительно должен быть вызван bsp-init.
Usage
/epf-expert bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]| Параметр | Обязательный | По умолчанию | Описание |
| ProcessorName | да | — | Имя обработки |
| Идентификатор | да | — | Внутреннее имя команды (латиница) |
| ТипКоманды | нет | из вида | Тип запуска |
| Представление | нет | = Идентификатор | Отображаемое имя |
| SrcDir | нет | src | Каталог исходников |
Маппинг типов команд
| Пользователь пишет | ТипКоманды |
| открыть форму | ТипКомандыОткрытиеФормы() |
| клиентский метод | ТипКомандыВызовКлиентскогоМетода() |
| серверный метод | ТипКомандыВызовСерверногоМетода() |
| заполнение формы | ТипКомандыЗаполнениеФормы() |
| сценарий | ТипКомандыСценарийВБезопасномРежиме() |
Шаблон вставляется перед Возврат ПараметрыРегистрации
НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
НоваяКоманда.Представление = НСтр("ru = '{{Представление}}'");
НоваяКоманда.Идентификатор = "{{Идентификатор}}";
НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
НоваяКоманда.ПоказыватьОповещение = Ложь;Инструкции
- Найди и прочитай
ObjectModule.bsl - Убедись что
СведенияОВнешнейОбработке()существует — если нет, предложиbsp-init - Определи вид обработки из существующего кода
- Вставь блок команды перед
Возврат ПараметрыРегистрации - Добавь обработчик: для серверных — в
ObjectModule.bsl, для клиентских — в модуль формы - Если обработчик уже есть — добавь ветку
ИначеЕсли, не дублируй процедуру
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
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.

