erf-expert

Name: erf-expert
Author: Arman-Kudaibergenov

150stars20forks

How to install erf-expert?

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

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

Installs into the current project.

Summary

Этот скилл MUST быть вызван для всех операций с внешними отчётами 1С (ERF): создание (init), сборка (build), разборка (dump). SHOULD также вызывать при любой работе с ERF-файлами и их исходниками. Do NOT использовать для внешних обработок (EPF) — используй epf-expert; для СКД вну

Files · 1

View on GitHub

SKILL.md

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

People who liked this also viewed

6 picks

Type

erf-expert

150stars20forks

View on GitHub

How to install erf-expert?

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

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

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

People who liked this also viewed

6 picks

Type