agentleFS
anymasoftanymasoft/1c-ai/.claude/skills/epf-expert/SKILL.md

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

The file

Files
SKILL.md

/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 и разреши базу:

  1. Если пользователь указал параметры (путь, сервер) — используй напрямую
  2. Если указал базу по имени — ищи в .v8-project.json
  3. Если не указал — сопоставь ветку Git с databases[].branches
  4. Если ветка не совпала — используй default
  5. Если .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"

	Возврат ПараметрыРегистрации;

КонецФункции

Инструкции

  1. Найди ObjectModule.bsl: src/{{ProcessorName}}/Ext/ObjectModule.bsl
  2. Если СведенияОВнешнейОбработке уже есть — сообщи, не дублируй
  3. Найди область #Область ПрограммныйИнтерфейс и вставь функцию внутрь
  4. Для видов с серверным обработчиком — добавь соответствующую процедуру после функции
  5. Используй табы для отступов

Режим: bsp-add-command — добавление команды БСП

Добавляет команду в существующую функцию СведенияОВнешнейОбработке(). Предварительно должен быть вызван bsp-init.

Usage

/epf-expert bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
ПараметрОбязательныйПо умолчаниюОписание
ProcessorNameда—Имя обработки
Идентификаторда—Внутреннее имя команды (латиница)
ТипКомандынетиз видаТип запуска
Представлениенет= ИдентификаторОтображаемое имя
SrcDirнетsrcКаталог исходников

Маппинг типов команд

Пользователь пишетТипКоманды
открыть формуТипКомандыОткрытиеФормы()
клиентский методТипКомандыВызовКлиентскогоМетода()
серверный методТипКомандыВызовСерверногоМетода()
заполнение формыТипКомандыЗаполнениеФормы()
сценарийТипКомандыСценарийВБезопасномРежиме()

Шаблон вставляется перед Возврат ПараметрыРегистрации

	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
	НоваяКоманда.Представление        = НСтр("ru = '{{Представление}}'");
	НоваяКоманда.Идентификатор        = "{{Идентификатор}}";
	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
	НоваяКоманда.ПоказыватьОповещение = Ложь;

Инструкции

  1. Найди и прочитай ObjectModule.bsl
  2. Убедись что СведенияОВнешнейОбработке() существует — если нет, предложи bsp-init
  3. Определи вид обработки из существующего кода
  4. Вставь блок команды перед Возврат ПараметрыРегистрации
  5. Добавь обработчик: для серверных — в ObjectModule.bsl, для клиентских — в модуль формы
  6. Если обработчик уже есть — добавь ветку ИначеЕсли, не дублируй процедуру

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.