epf-expert

Name: epf-expert
Author: Arman-Kudaibergenov

150stars20forks

How to install epf-expert?

arman-kudaibergenov/1c-ai-development-kit/epf-expert

$npx -y skills add Arman-Kudaibergenov/1c-ai-development-kit --skill epf-expert

Installs into the current project.

Summary

Этот скилл MUST быть вызван для всех операций с внешними обработками 1С (EPF): создание (init), сборка (build), разборка (dump), добавление формы (add-form), регистрация в БСП (bsp-init), добавление команды БСП (bsp-add-command). SHOULD также вызывать при любой работе с EPF-файла

Files · 1

View on GitHub

SKILL.md

1	# /epf-expert — Внешние обработки 1С (EPF)
2
3	Единый скилл для всех операций с внешними обработками EPF. Выбери нужный режим:
4
5	\| Режим \| Что делает \|
6	\|-------\|-----------\|
7	\| `init` \| Создать новую пустую обработку (scaffold XML) \|
8	\| `build` \| Собрать EPF из XML-исходников \|
9	\| `dump` \| Разобрать EPF в XML-исходники \|
10	\| `add-form` \| Добавить управляемую форму к обработке \|
11	\| `bsp-init` \| Зарегистрировать обработку в подсистеме БСП \|
12	\| `bsp-add-command` \| Добавить команду в регистрацию БСП \|
13
14	---
15
16	## Режим: init — создание обработки
17
18	Генерирует минимальный набор XML-исходников для внешней обработки (EPF) 1С.
19
20	### Usage
21
22	```
23	/epf-expert init <Name> [Synonym] [SrcDir]
24	```
25
26	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
27	\|----------\|:------------:\|--------------\|----------\|
28	\| Name \| да \| — \| Имя обработки (латиница/кириллица) \|
29	\| Synonym \| нет \| = Name \| Синоним (отображаемое имя) \|
30	\| SrcDir \| нет \| `src` \| Каталог исходников относительно CWD \|
31
32	### Команда
33
34	```powershell
35	powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
36	```
37
38	### Что создаётся
39
40	```
41	<SrcDir>/
42	├── <Name>.xml # Корневой файл метаданных (4 UUID)
43	└── <Name>/
44	└── Ext/
45	└── ObjectModule.bsl # Модуль объекта с 3 регионами
46	```
47
48	- Корневой XML содержит `MetaDataObject/ExternalDataProcessor` с пустыми `DefaultForm` и `ChildObjects`
49	- ClassId фиксирован: `c3831ec8-d8d5-4f93-8a22-f9bfae07327f`
50	- Файл создаётся в UTF-8 с BOM
51
52	### Дальнейшие шаги
53
54	- Добавить форму: `/epf-expert add-form`
55	- Добавить макет: `/mxl-expert template-add`
56	- Добавить справку: `/help-add`
57	- Собрать EPF: `/epf-expert build`
58
59	---
60
61	## Режим: build — сборка EPF
62
63	Собирает EPF файл из XML-исходников с помощью платформы 1С.
64
65	### Usage
66
67	```
68	/epf-expert build <Name> [SrcDir] [OutDir]
69	```
70
71	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
72	\|----------\|:------------:\|--------------\|----------\|
73	\| Name \| да \| — \| Имя объекта (имя корневого XML) \|
74	\| SrcDir \| нет \| `src` \| Каталог исходников \|
75	\| OutDir \| нет \| `build` \| Каталог для результата \|
76
77	### Параметры подключения
78
79	Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
80	1. Если пользователь указал параметры (путь, сервер) — используй напрямую
81	2. Если указал базу по имени — ищи в `.v8-project.json`
82	3. Если не указал — сопоставь ветку Git с `databases[].branches`
83	4. Если ветка не совпала — используй `default`
84	5. Если `.v8-project.json` нет — создай пустую ИБ в `./base`
85
86	Если `v8path` не задан: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" \| Sort -Desc \| Select -First 1`
87
88	### Команда
89
90	```powershell
91	powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-build.ps1 -InfoBasePath "<путь>" -SourceFile "src\<Name>.xml" -OutputFile "build\<Name>.epf"
92	```
93
94	\| Параметр \| Обязательный \| Описание \|
95	\|----------\|:------------:\|----------\|
96	\| `-V8Path <путь>` \| нет \| Каталог bin платформы \|
97	\| `-InfoBasePath <путь>` \| * \| Файловая база \|
98	\| `-InfoBaseServer <сервер>` \| * \| Сервер 1С \|
99	\| `-InfoBaseRef <имя>` \| * \| Имя базы на сервере \|
100	\| `-UserName <имя>` \| нет \| Пользователь \|
101	\| `-Password <пароль>` \| нет \| Пароль \|
102	\| `-SourceFile <путь>` \| да \| Корневой XML исходников \|
103	\| `-OutputFile <путь>` \| да \| Выходной EPF файл \|
104
105	> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
106
107	Примечание: Если объект использует ссылочные типы конфигурации — сборка в пустой базе упадёт с ошибкой XDTO. Зарегистрируй базу с целевой конфигурацией через `/db-list add`.
108
109	---
110
111	## Режим: dump — разборка EPF
112
113	Разбирает EPF файл в XML-исходники с помощью платформы 1С (иерархический формат).
114
115	### Usage
116
117	```
118	/epf-expert dump <File> [OutDir]
119	```
120
121	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
122	\|----------\|:------------:\|--------------\|----------\|
123	\| File \| да \| — \| Путь к EPF файлу \|
124	\| OutDir \| нет \| `src` \| Каталог для выгрузки исходников \|
125
126	### Параметры подключения
127
128	Аналогично режиму `build` — разрешение базы через `.v8-project.json`.
129
130	### Команда
131
132	```powershell
133	powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-dump.ps1 -InfoBasePath "<путь>" -InputFile "<файл>.epf" -OutputDir "src"
134	```
135
136	\| П

People who liked this also viewed

6 picks

Type

epf-expert

150stars20forks

View on GitHub

How to install epf-expert?

arman-kudaibergenov/1c-ai-development-kit/epf-expert

$npx -y skills add Arman-Kudaibergenov/1c-ai-development-kit --skill epf-expert

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /epf-expert — Внешние обработки 1С (EPF)
2
3	Единый скилл для всех операций с внешними обработками EPF. Выбери нужный режим:
4
5	\| Режим \| Что делает \|
6	\|-------\|-----------\|
7	\| `init` \| Создать новую пустую обработку (scaffold XML) \|
8	\| `build` \| Собрать EPF из XML-исходников \|
9	\| `dump` \| Разобрать EPF в XML-исходники \|
10	\| `add-form` \| Добавить управляемую форму к обработке \|
11	\| `bsp-init` \| Зарегистрировать обработку в подсистеме БСП \|
12	\| `bsp-add-command` \| Добавить команду в регистрацию БСП \|
13
14	---
15
16	## Режим: init — создание обработки
17
18	Генерирует минимальный набор XML-исходников для внешней обработки (EPF) 1С.
19
20	### Usage
21
22	```
23	/epf-expert init <Name> [Synonym] [SrcDir]
24	```
25
26	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
27	\|----------\|:------------:\|--------------\|----------\|
28	\| Name \| да \| — \| Имя обработки (латиница/кириллица) \|
29	\| Synonym \| нет \| = Name \| Синоним (отображаемое имя) \|
30	\| SrcDir \| нет \| `src` \| Каталог исходников относительно CWD \|
31
32	### Команда
33
34	```powershell
35	powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
36	```
37
38	### Что создаётся
39
40	```
41	<SrcDir>/
42	├── <Name>.xml # Корневой файл метаданных (4 UUID)
43	└── <Name>/
44	└── Ext/
45	└── ObjectModule.bsl # Модуль объекта с 3 регионами
46	```
47
48	- Корневой XML содержит `MetaDataObject/ExternalDataProcessor` с пустыми `DefaultForm` и `ChildObjects`
49	- ClassId фиксирован: `c3831ec8-d8d5-4f93-8a22-f9bfae07327f`
50	- Файл создаётся в UTF-8 с BOM
51
52	### Дальнейшие шаги
53
54	- Добавить форму: `/epf-expert add-form`
55	- Добавить макет: `/mxl-expert template-add`
56	- Добавить справку: `/help-add`
57	- Собрать EPF: `/epf-expert build`
58
59	---
60
61	## Режим: build — сборка EPF
62
63	Собирает EPF файл из XML-исходников с помощью платформы 1С.
64
65	### Usage
66
67	```
68	/epf-expert build <Name> [SrcDir] [OutDir]
69	```
70
71	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
72	\|----------\|:------------:\|--------------\|----------\|
73	\| Name \| да \| — \| Имя объекта (имя корневого XML) \|
74	\| SrcDir \| нет \| `src` \| Каталог исходников \|
75	\| OutDir \| нет \| `build` \| Каталог для результата \|
76
77	### Параметры подключения
78
79	Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` и разреши базу:
80	1. Если пользователь указал параметры (путь, сервер) — используй напрямую
81	2. Если указал базу по имени — ищи в `.v8-project.json`
82	3. Если не указал — сопоставь ветку Git с `databases[].branches`
83	4. Если ветка не совпала — используй `default`
84	5. Если `.v8-project.json` нет — создай пустую ИБ в `./base`
85
86	Если `v8path` не задан: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" \| Sort -Desc \| Select -First 1`
87
88	### Команда
89
90	```powershell
91	powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-build.ps1 -InfoBasePath "<путь>" -SourceFile "src\<Name>.xml" -OutputFile "build\<Name>.epf"
92	```
93
94	\| Параметр \| Обязательный \| Описание \|
95	\|----------\|:------------:\|----------\|
96	\| `-V8Path <путь>` \| нет \| Каталог bin платформы \|
97	\| `-InfoBasePath <путь>` \| * \| Файловая база \|
98	\| `-InfoBaseServer <сервер>` \| * \| Сервер 1С \|
99	\| `-InfoBaseRef <имя>` \| * \| Имя базы на сервере \|
100	\| `-UserName <имя>` \| нет \| Пользователь \|
101	\| `-Password <пароль>` \| нет \| Пароль \|
102	\| `-SourceFile <путь>` \| да \| Корневой XML исходников \|
103	\| `-OutputFile <путь>` \| да \| Выходной EPF файл \|
104
105	> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
106
107	Примечание: Если объект использует ссылочные типы конфигурации — сборка в пустой базе упадёт с ошибкой XDTO. Зарегистрируй базу с целевой конфигурацией через `/db-list add`.
108
109	---
110
111	## Режим: dump — разборка EPF
112
113	Разбирает EPF файл в XML-исходники с помощью платформы 1С (иерархический формат).
114
115	### Usage
116
117	```
118	/epf-expert dump <File> [OutDir]
119	```
120
121	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
122	\|----------\|:------------:\|--------------\|----------\|
123	\| File \| да \| — \| Путь к EPF файлу \|
124	\| OutDir \| нет \| `src` \| Каталог для выгрузки исходников \|
125
126	### Параметры подключения
127
128	Аналогично режиму `build` — разрешение базы через `.v8-project.json`.
129
130	### Команда
131
132	```powershell
133	powershell.exe -NoProfile -File .claude/skills/epf-expert/scripts/epf-dump.ps1 -InfoBasePath "<путь>" -InputFile "<файл>.epf" -OutputDir "src"
134	```
135
136	\| П

People who liked this also viewed

6 picks

Type