Add ERF skills and universalize template/help skills

- Add /erf-init: scaffold external report with optional --WithSKD - Add /erf-build, /erf-dump: instructive skills for ERF build/dump CLI - Rename /epf-add-template → /template-add: universal, auto-fill MainDataCompositionSchema for reports - Rename /epf-add-help → /help-add: universal for any object type - Extend /form-add: support ExternalDataProcessor and ExternalReport - Update cross-references in epf-init, epf-bsp-init, epf-build, epf-dump Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-08-07 20:20:20 +03:00 · 2026-02-14 18:00:36 +03:00
parent 1312cd7db4
commit be47935973
14 changed files with 513 additions and 45 deletions
@@ -204,5 +204,5 @@ allowed-tools:

 - Добавить ещё команду: `/epf-bsp-add-command`
 - Добавить форму: `/epf-add-form`
- Добавить макет: `/epf-add-template`
+- Добавить макет: `/template-add`
 - Собрать EPF: `/epf-build`
@@ -1,6 +1,6 @@
 ---
 name: epf-build
-description: Собрать внешнюю обработку 1С (EPF) из XML-исходников
+description: Собрать внешнюю обработку 1С (EPF/ERF) из XML-исходников
 argument-hint: <ProcessorName>
 allowed-tools:
  - Bash
@@ -11,7 +11,7 @@ allowed-tools:

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

-Собирает EPF-файл из XML-исходников с помощью платформы 1С.
+Собирает EPF-файл из XML-исходников с помощью платформы 1С. Та же команда CLI работает и для внешних отчётов (ERF) — см. `/erf-build`.

 ## Usage

@@ -1,6 +1,6 @@
 ---
 name: epf-dump
-description: Разобрать EPF-файл обработки 1С в XML-исходники
+description: Разобрать EPF-файл обработки 1С (EPF/ERF) в XML-исходники
 argument-hint: <EpfFile>
 allowed-tools:
  - Bash
@@ -11,7 +11,7 @@ allowed-tools:

 # /epf-dump — Разборка обработки

-Разбирает EPF-файл во XML-исходники с помощью платформы 1С (иерархический формат).
+Разбирает EPF-файл во XML-исходники с помощью платформы 1С (иерархический формат). Та же команда CLI работает и для внешних отчётов (ERF) — см. `/erf-dump`.

 ## Usage

@@ -50,5 +50,6 @@ pwsh -NoProfile -File .claude/skills/epf-init/scripts/init.ps1 -Name "<Name>" [-
 ## Дальнейшие шаги

 - Добавить форму: `/epf-add-form`
- Добавить макет: `/epf-add-template`
+- Добавить макет: `/template-add`
+- Добавить справку: `/help-add`
 - Собрать EPF: `/epf-build`
@@ -0,0 +1,83 @@
+---
+name: erf-build
+description: Собрать внешний отчёт 1С (ERF) из XML-исходников
+argument-hint: <ReportName>
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+  - Grep
+---
+
+# /erf-build — Сборка отчёта
+
+Собирает ERF-файл из XML-исходников с помощью платформы 1С. Использует ту же команду CLI, что и `/epf-build`.
+
+## Usage
+
+```
+/erf-build <ReportName> [SrcDir] [OutDir]
+```
+
+| Параметр   | Обязательный | По умолчанию | Описание                             |
+|------------|:------------:|--------------|--------------------------------------|
+| ReportName | да           | —            | Имя отчёта (имя корневого XML)       |
+| SrcDir     | нет          | `src`        | Каталог исходников                   |
+| OutDir     | нет          | `build`      | Каталог для результата               |
+
+## Переменные окружения
+
+| Переменная | Описание                              | Пример                                        |
+|------------|---------------------------------------|-----------------------------------------------|
+| V8_PATH    | Каталог bin платформы 1С              | `C:\Program Files\1cv8\8.3.25.1257\bin`       |
+| V8_BASE    | Путь к пустой файловой ИБ            | `.\base`                                      |
+
+## Команды
+
+### 1. Создать пустую ИБ (если нет)
+
+```cmd
+"%V8_PATH%\1cv8.exe" CREATEINFOBASE File="%V8_BASE%"
+```
+
+### 2. Сборка ERF из XML
+
+```cmd
+"%V8_PATH%\1cv8.exe" DESIGNER /F "%V8_BASE%" /DisableStartupDialogs /LoadExternalDataProcessorOrReportFromFiles "<SrcDir>\<ReportName>.xml" "<OutDir>\<ReportName>.erf" /Out "<OutDir>\build.log"
+```
+
+## Коды возврата
+
+| Код | Описание                    |
+|-----|-----------------------------|
+| 0   | Успешная сборка             |
+| 1   | Ошибка (см. лог)           |
+
+## Автоопределение платформы (Windows)
+
+Если `V8_PATH` не задан, можно найти автоматически:
+
+```powershell
+$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1
+```
+
+## Ссылочные типы и выбор базы
+
+Пустая ИБ (`V8_BASE`) подходит для сборки, если формы используют только базовые типы (`xs:string`, `xs:boolean` и т.д.) или тип самого отчёта (`ExternalReportObject.Имя`).
+
+Если отчёт использует ссылочные типы конфигурации (`CatalogRef.XXX`, `DocumentRef.XXX` и т.д.) — в реквизитах объекта, табличных частях или реквизитах форм — **сборка в пустой базе упадёт** с ошибкой XDTO. Платформа не может резолвить типы, отсутствующие в конфигурации базы.
+
+**Решение**: собирать в базе с целевой конфигурацией. Если конфигурация неизвестна — спросить пользователя путь к базе.
+
+## Пример полного цикла
+
+```powershell
+$env:V8_PATH = "C:\Program Files\1cv8\8.3.25.1257\bin"
+$env:V8_BASE = ".\base"
+
+# Создать ИБ
+& "$env:V8_PATH\1cv8.exe" CREATEINFOBASE "File=$env:V8_BASE"
+
+# Собрать
+& "$env:V8_PATH\1cv8.exe" DESIGNER /F $env:V8_BASE /DisableStartupDialogs /LoadExternalDataProcessorOrReportFromFiles "src\МойОтчёт.xml" "build\МойОтчёт.erf" /Out "build\build.log"
+```
@@ -0,0 +1,90 @@
+---
+name: erf-dump
+description: Разобрать ERF-файл отчёта 1С в XML-исходники
+argument-hint: <ErfFile>
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+  - Grep
+---
+
+# /erf-dump — Разборка отчёта
+
+Разбирает ERF-файл во XML-исходники с помощью платформы 1С (иерархический формат). Использует ту же команду CLI, что и `/epf-dump`.
+
+## Usage
+
+```
+/erf-dump <ErfFile> [OutDir]
+```
+
+| Параметр | Обязательный | По умолчанию | Описание                            |
+|----------|:------------:|--------------|-------------------------------------|
+| ErfFile  | да           | —            | Путь к ERF-файлу                    |
+| OutDir   | нет          | `src`        | Каталог для выгрузки исходников     |
+
+## Переменные окружения
+
+| Переменная | Описание                              | Пример                                        |
+|------------|---------------------------------------|-----------------------------------------------|
+| V8_PATH    | Каталог bin платформы 1С              | `C:\Program Files\1cv8\8.3.25.1257\bin`       |
+| V8_BASE    | Путь к пустой файловой ИБ            | `.\base`                                      |
+
+## Команды
+
+### 1. Создать пустую ИБ (если нет)
+
+```cmd
+"%V8_PATH%\1cv8.exe" CREATEINFOBASE File="%V8_BASE%"
+```
+
+### 2. Разборка ERF в XML
+
+```cmd
+"%V8_PATH%\1cv8.exe" DESIGNER /F "%V8_BASE%" /DisableStartupDialogs /DumpExternalDataProcessorOrReportToFiles "<OutDir>" "<ErfFile>" -Format Hierarchical /Out "<OutDir>\dump.log"
+```
+
+## Коды возврата
+
+| Код | Описание                    |
+|-----|-----------------------------|
+| 0   | Успешная разборка           |
+| 1   | Ошибка (см. лог)           |
+
+## Формат `-Format Hierarchical`
+
+Ключ `-Format Hierarchical` создаёт структуру каталогов:
+
+```
+<OutDir>/
+├── <Name>.xml                    # Корневой файл
+└── <Name>/
+    ├── Ext/
+    │   └── ObjectModule.bsl      # Модуль объекта (если есть)
+    ├── Forms/
+    │   ├── <FormName>.xml
+    │   └── <FormName>/
+    │       └── Ext/
+    │           ├── Form.xml
+    │           └── Form/
+    │               └── Module.bsl
+    └── Templates/
+        ├── <TemplateName>.xml
+        └── <TemplateName>/
+            └── Ext/
+                └── Template.<ext>
+```
+
+## Пример полного цикла
+
+```powershell
+$env:V8_PATH = "C:\Program Files\1cv8\8.3.25.1257\bin"
+$env:V8_BASE = ".\base"
+
+# Создать ИБ
+& "$env:V8_PATH\1cv8.exe" CREATEINFOBASE "File=$env:V8_BASE"
+
+# Разобрать
+& "$env:V8_PATH\1cv8.exe" DESIGNER /F $env:V8_BASE /DisableStartupDialogs /DumpExternalDataProcessorOrReportToFiles "src" "build\МойОтчёт.erf" -Format Hierarchical /Out "build\dump.log"
+```
@@ -0,0 +1,68 @@
+---
+name: erf-init
+description: Создать пустой внешний отчёт 1С (scaffold XML-исходников)
+argument-hint: <Name> [Synonym] [--with-skd]
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+---
+
+# /erf-init — Создание нового отчёта
+
+Генерирует минимальный набор XML-исходников для внешнего отчёта 1С: корневой файл метаданных и каталог отчёта.
+
+## Usage
+
+```
+/erf-init <Name> [Synonym] [SrcDir] [--with-skd]
+```
+
+| Параметр  | Обязательный | По умолчанию | Описание                              |
+|-----------|:------------:|--------------|---------------------------------------|
+| Name      | да           | —            | Имя отчёта (латиница/кириллица)       |
+| Synonym   | нет          | = Name       | Синоним (отображаемое имя)            |
+| SrcDir    | нет          | `src`        | Каталог исходников относительно CWD   |
+| --WithSKD | нет          | —            | Создать пустую СКД и привязать к MainDataCompositionSchema |
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File .claude\skills\erf-init\scripts\init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
+```
+
+## Что создаётся
+
+```
+<SrcDir>/
+├── <Name>.xml          # Корневой файл метаданных (4 UUID)
+└── <Name>/
+    └── Ext/
+        └── ObjectModule.bsl  # Модуль объекта с 3 регионами
+```
+
+При `--WithSKD` дополнительно:
+
+```
+<SrcDir>/<Name>/
+    Templates/
+    ├── ОсновнаяСхемаКомпоновкиДанных.xml        # Метаданные макета
+    └── ОсновнаяСхемаКомпоновкиДанных/
+        └── Ext/
+            └── Template.xml                      # Пустая СКД
+```
+
+- Корневой XML содержит `MetaDataObject/ExternalReport` с пустыми `DefaultForm`, `MainDataCompositionSchema` и `ChildObjects`
+- При `--WithSKD` — `MainDataCompositionSchema` заполняется ссылкой на макет, `ChildObjects` содержит `<Template>`
+- ClassId фиксирован: `e41aff26-25cf-4bb6-b6c1-3f478a75f374`
+- Файл создаётся в UTF-8 с BOM
+
+## Дальнейшие шаги
+
+- Добавить форму: `/form-add`
+- Добавить макет: `/template-add`
+- Добавить справку: `/help-add`
+- Собрать ERF: `/erf-build`
@@ -0,0 +1,178 @@
+# erf-init v1.0 — Init 1C external report scaffold
+# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
+param(
+	[Parameter(Mandatory)]
+	[string]$Name,
+
+	[string]$Synonym = $Name,
+
+	[string]$SrcDir = "src",
+
+	[switch]$WithSKD
+)
+
+$ErrorActionPreference = "Stop"
+
+$uuid1 = [guid]::NewGuid().ToString()
+$uuid2 = [guid]::NewGuid().ToString()
+$uuid3 = [guid]::NewGuid().ToString()
+$uuid4 = [guid]::NewGuid().ToString()
+
+# --- Формируем Properties ---
+
+$mainDCSValue = ""
+$childObjectsContent = ""
+
+if ($WithSKD) {
+	$mainDCSValue = "ExternalReport.$Name.Template.ОсновнаяСхемаКомпоновкиДанных"
+	$childObjectsContent = @"
+
+			<Template>ОсновнаяСхемаКомпоновкиДанных</Template>
+
+"@
+}
+
+$mainDCSElement = if ($mainDCSValue) {
+	"<MainDataCompositionSchema>$mainDCSValue</MainDataCompositionSchema>"
+} else {
+	"<MainDataCompositionSchema/>"
+}
+
+$childObjectsXml = if ($childObjectsContent) {
+	"<ChildObjects>$childObjectsContent</ChildObjects>"
+} else {
+	"<ChildObjects/>"
+}
+
+$xml = @"
+<?xml version="1.0" encoding="UTF-8"?>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<ExternalReport uuid="$uuid1">
+		<InternalInfo>
+			<xr:ContainedObject>
+				<xr:ClassId>e41aff26-25cf-4bb6-b6c1-3f478a75f374</xr:ClassId>
+				<xr:ObjectId>$uuid2</xr:ObjectId>
+			</xr:ContainedObject>
+			<xr:GeneratedType name="ExternalReportObject.$Name" category="Object">
+				<xr:TypeId>$uuid3</xr:TypeId>
+				<xr:ValueId>$uuid4</xr:ValueId>
+			</xr:GeneratedType>
+		</InternalInfo>
+		<Properties>
+			<Name>$Name</Name>
+			<Synonym>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>$Synonym</v8:content>
+				</v8:item>
+			</Synonym>
+			<Comment/>
+			<DefaultForm/>
+			<AuxiliaryForm/>
+			$mainDCSElement
+			<DefaultSettingsForm/>
+			<AuxiliarySettingsForm/>
+			<DefaultVariantForm/>
+			<VariantsStorage/>
+			<SettingsStorage/>
+		</Properties>
+		$childObjectsXml
+	</ExternalReport>
+</MetaDataObject>
+"@
+
+$rootFile = Join-Path $SrcDir "$Name.xml"
+$reportDir = Join-Path $SrcDir $Name
+
+if (Test-Path $rootFile) {
+	Write-Error "Файл уже существует: $rootFile"
+	exit 1
+}
+
+if (-not (Test-Path $SrcDir)) {
+	New-Item -ItemType Directory -Path $SrcDir -Force | Out-Null
+}
+$extDir = Join-Path $reportDir "Ext"
+New-Item -ItemType Directory -Path $extDir -Force | Out-Null
+
+$enc = New-Object System.Text.UTF8Encoding($true)
+[System.IO.File]::WriteAllText((Resolve-Path $SrcDir | Join-Path -ChildPath "$Name.xml"), $xml, $enc)
+
+# --- Модуль объекта ---
+
+$moduleBsl = @"
+#Область ОписаниеПеременных
+
+#КонецОбласти
+
+#Область ПрограммныйИнтерфейс
+
+#КонецОбласти
+
+#Область СлужебныеПроцедурыИФункции
+
+#КонецОбласти
+"@
+
+$modulePath = Join-Path $extDir "ObjectModule.bsl"
+[System.IO.File]::WriteAllText($modulePath, $moduleBsl, $enc)
+
+Write-Host "[OK] Создан отчёт: $rootFile"
+Write-Host "     Каталог: $reportDir"
+Write-Host "     Модуль:  $modulePath"
+
+# --- СКД-макет (если --WithSKD) ---
+
+if ($WithSKD) {
+	$templatesDir = Join-Path $reportDir "Templates"
+	$skdName = "ОсновнаяСхемаКомпоновкиДанных"
+	$skdMetaPath = Join-Path $templatesDir "$skdName.xml"
+	$skdExtDir = Join-Path (Join-Path $templatesDir $skdName) "Ext"
+	New-Item -ItemType Directory -Path $skdExtDir -Force | Out-Null
+
+	$skdUuid = [guid]::NewGuid().ToString()
+
+	$skdMetaXml = @"
+<?xml version="1.0" encoding="UTF-8"?>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<Template uuid="$skdUuid">
+		<Properties>
+			<Name>$skdName</Name>
+			<Synonym>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>Основная схема компоновки данных</v8:content>
+				</v8:item>
+			</Synonym>
+			<Comment/>
+			<TemplateType>DataCompositionSchema</TemplateType>
+		</Properties>
+	</Template>
+</MetaDataObject>
+"@
+
+	[System.IO.File]::WriteAllText($skdMetaPath, $skdMetaXml, $enc)
+
+	$skdContent = @"
+<?xml version="1.0" encoding="UTF-8"?>
+<DataCompositionSchema xmlns="http://v8.1c.ru/8.1/data-composition-system/schema"
+		xmlns:dcscom="http://v8.1c.ru/8.1/data-composition-system/common"
+		xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core"
+		xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"
+		xmlns:v8="http://v8.1c.ru/8.1/data/core"
+		xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"
+		xmlns:xs="http://www.w3.org/2001/XMLSchema"
+		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+	<dataSource>
+		<name>ИсточникДанных1</name>
+		<dataSourceType>Local</dataSourceType>
+	</dataSource>
+</DataCompositionSchema>
+"@
+
+	$skdFilePath = Join-Path $skdExtDir "Template.xml"
+	[System.IO.File]::WriteAllText($skdFilePath, $skdContent, $enc)
+
+	Write-Host "     СКД:     $skdMetaPath"
+	Write-Host "     Тело:    $skdFilePath"
+}
@@ -39,7 +39,7 @@ powershell.exe -NoProfile -File .claude\skills\form-add\scripts\form-add.ps1 -Ob

 | Purpose | Допустимые типы объектов | Основной реквизит | DefaultForm-свойство |
 |---------|-------------------------|-------------------|---------------------|
-| Object  | Document, Catalog, DataProcessor, Report, ChartOf*, ExchangePlan, BusinessProcess, Task | Объект (тип: *Object.Имя) | DefaultObjectForm (DefaultForm для DataProcessor/Report) |
+| Object  | Document, Catalog, DataProcessor, Report, ExternalDataProcessor, ExternalReport, ChartOf*, ExchangePlan, BusinessProcess, Task | Объект (тип: *Object.Имя) | DefaultObjectForm (DefaultForm для DataProcessor/Report/ExternalDataProcessor/ExternalReport) |
 | List    | Все кроме DataProcessor | Список (DynamicList) | DefaultListForm |
 | Choice  | Document, Catalog, ChartOf*, ExchangePlan, BusinessProcess, Task | Список (DynamicList) | DefaultChoiceForm |
 | Record  | InformationRegister | Запись (InformationRegisterRecordManager) | DefaultRecordForm |
@@ -62,7 +62,7 @@ powershell.exe -NoProfile -File .claude\skills\form-add\scripts\form-add.ps1 -Ob

 ## Поддерживаемые типы объектов

-Document, Catalog, DataProcessor, Report, InformationRegister, ChartOfAccounts, ChartOfCharacteristicTypes, ExchangePlan, BusinessProcess, Task
+Document, Catalog, DataProcessor, Report, ExternalDataProcessor, ExternalReport, InformationRegister, ChartOfAccounts, ChartOfCharacteristicTypes, ExchangePlan, BusinessProcess, Task

 ## Примеры

@@ -41,6 +41,7 @@ if (-not $metaDataObject) {

 $supportedTypes = @(
 	"Document", "Catalog", "DataProcessor", "Report",
+	"ExternalDataProcessor", "ExternalReport",
 	"InformationRegister", "ChartOfAccounts", "ChartOfCharacteristicTypes",
 	"ExchangePlan", "BusinessProcess", "Task"
 )
@@ -89,7 +90,7 @@ switch ($Purpose) {
 }

 $objectLikeTypes = @("Document", "Catalog", "ChartOfAccounts", "ChartOfCharacteristicTypes", "ExchangePlan", "BusinessProcess", "Task")
-$processorLikeTypes = @("DataProcessor", "Report")
+$processorLikeTypes = @("DataProcessor", "Report", "ExternalDataProcessor", "ExternalReport")

 switch ($Purpose) {
 	"Object" {
@@ -235,6 +236,8 @@ if ($Purpose -eq "List" -or $Purpose -eq "Choice") {
 		"Catalog"                     = "CatalogObject"
 		"DataProcessor"               = "DataProcessorObject"
 		"Report"                      = "ReportObject"
+		"ExternalDataProcessor"       = "ExternalDataProcessorObject"
+		"ExternalReport"              = "ExternalReportObject"
 		"ChartOfAccounts"             = "ChartOfAccountsObject"
 		"ChartOfCharacteristicTypes"  = "ChartOfCharacteristicTypesObject"
 		"ExchangePlan"                = "ExchangePlanObject"
@@ -1,7 +1,7 @@
 ---
-name: epf-add-help
-description: Добавить встроенную справку к внешней обработке 1С
-argument-hint: <ProcessorName>
+name: help-add
+description: Добавить встроенную справку к объекту 1С (обработка, отчёт, справочник, документ и др.)
+argument-hint: <ObjectName>
 allowed-tools:
  - Bash
  - Read
@@ -11,32 +11,32 @@ allowed-tools:
  - Grep
 ---

-# /epf-add-help — Добавление справки
+# /help-add — Добавление справки

-Добавляет встроенную справку к обработке: файл метаданных `Help.xml`, HTML-страницу и при необходимости обновляет метаданные форм.
+Добавляет встроенную справку к объекту: файл метаданных `Help.xml`, HTML-страницу и при необходимости обновляет метаданные форм.

 ## Usage

 ```
-/epf-add-help <ProcessorName> [Lang] [SrcDir]
+/help-add <ObjectName> [Lang] [SrcDir]
 ```

-| Параметр      | Обязательный | По умолчанию | Описание                            |
-|---------------|:------------:|--------------|-------------------------------------|
-| ProcessorName | да           | —            | Имя обработки                       |
-| Lang          | нет          | `ru`         | Код языка справки                   |
-| SrcDir        | нет          | `src`        | Каталог исходников                  |
+| Параметр   | Обязательный | По умолчанию | Описание                            |
+|------------|:------------:|--------------|-------------------------------------|
+| ObjectName | да           | —            | Имя объекта                         |
+| Lang       | нет          | `ru`         | Код языка справки                   |
+| SrcDir     | нет          | `src`        | Каталог исходников                  |

 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-add-help/scripts/add-help.ps1 -ProcessorName "<ProcessorName>" [-Lang "<Lang>"] [-SrcDir "<SrcDir>"]
+powershell.exe -NoProfile -File .claude\skills\help-add\scripts\add-help.ps1 -ObjectName "<ObjectName>" [-Lang "<Lang>"] [-SrcDir "<SrcDir>"]
 ```

 ## Что создаётся

 ```
-<SrcDir>/<ProcessorName>/
+<SrcDir>/<ObjectName>/
    Ext/
        Help.xml                    # Метаданные справки (namespace extrnprops)
        Help/
@@ -49,13 +49,13 @@ powershell.exe -NoProfile -File .claude/skills/epf-add-help/scripts/add-help.ps1

 ## Что модифицируется

- Если в метаданных формы (`Forms/<FormName>.xml`) отсутствует `<IncludeHelpInContents>` — скрипт добавит `<IncludeHelpInContents>false</IncludeHelpInContents>` после `<FormType>`. Для форм, созданных через `/epf-add-form`, элемент уже есть.
+- Если в метаданных формы (`Forms/<FormName>.xml`) отсутствует `<IncludeHelpInContents>` — скрипт добавит `<IncludeHelpInContents>false</IncludeHelpInContents>` после `<FormType>`. Для форм, созданных через `/form-add`, элемент уже есть.

 ## Кнопка справки на форме

 После создания справки для её вызова нужна кнопка на форме. Добавь кнопку `Form.StandardCommand.Help` в AutoCommandBar формы (`Forms/<FormName>/Ext/Form.xml`).

-### Текущая структура AutoCommandBar (созданная epf-add-form)
+### Текущая структура AutoCommandBar (созданная form-add)

 ```xml
 <AutoCommandBar name="ФормаКоманднаяПанель" id="-1">
@@ -89,4 +89,4 @@ powershell.exe -NoProfile -File .claude/skills/epf-add-help/scripts/add-help.ps1

 ## Редактирование справки

-После создания содержимое справки — обычный HTML. Отредактируй `Ext/Help/ru.html` в соответствии с назначением обработки. Поддерживается стандартная HTML-разметка: `<h1>`..`<h4>`, `<p>`, `<ul>`, `<ol>`, `<table>`, `<strong>`, `<em>`, `<a>`, `<pre>`.
+После создания содержимое справки — обычный HTML. Отредактируй `Ext/Help/ru.html` в соответствии с назначением объекта. Поддерживается стандартная HTML-разметка: `<h1>`..`<h4>`, `<p>`, `<ul>`, `<ol>`, `<table>`, `<strong>`, `<em>`, `<a>`, `<pre>`.
@@ -1,8 +1,9 @@
-# epf-add-help v1.0 — Add built-in help to 1C processor
+# help-add v1.1 — Add built-in help to 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
-	[string]$ProcessorName,
+	[Alias("ProcessorName")]
+	[string]$ObjectName,

 	[string]$Lang = "ru",

@@ -13,7 +14,7 @@ $ErrorActionPreference = "Stop"

 # --- Проверки ---

-$processorDir = Join-Path $SrcDir $ProcessorName
+$processorDir = Join-Path $SrcDir $ObjectName
 $extDir = Join-Path $processorDir "Ext"

 if (-not (Test-Path $extDir)) {
@@ -57,7 +58,7 @@ $helpHtml = @"
    <link rel="stylesheet" type="text/css" href="v8help://service_book/service_style"/>
 </head>
 <body>
-    <h1>$ProcessorName</h1>
+    <h1>$ObjectName</h1>
    <p>Описание обработки.</p>
 </body>
 </html>
@@ -112,6 +113,6 @@ if (Test-Path $formsDir) {
 	}
 }

-Write-Host "[OK] Создана справка: $ProcessorName"
+Write-Host "[OK] Создана справка: $ObjectName"
 Write-Host "     Метаданные: $helpXmlPath"
 Write-Host "     Страница:   $helpHtmlPath"
@@ -1,7 +1,7 @@
 ---
-name: epf-add-template
-description: Добавить макет к внешней обработке 1С
-argument-hint: <ProcessorName> <TemplateName> <TemplateType>
+name: template-add
+description: Добавить макет к объекту 1С (обработка, отчёт, справочник, документ и др.)
+argument-hint: <ObjectName> <TemplateName> <TemplateType>
 allowed-tools:
  - Bash
  - Read
@@ -11,28 +11,29 @@ allowed-tools:
  - Grep
 ---

-# /epf-add-template — Добавление макета
+# /template-add — Добавление макета

-Создаёт макет указанного типа и регистрирует его в корневом XML обработки.
+Создаёт макет указанного типа и регистрирует его в корневом XML объекта.

 ## Usage

 ```
-/epf-add-template <ProcessorName> <TemplateName> <TemplateType>
+/template-add <ObjectName> <TemplateName> <TemplateType>
 ```

 | Параметр      | Обязательный | По умолчанию    | Описание                                         |
 |---------------|:------------:|-----------------|--------------------------------------------------|
-| ProcessorName | да           | —               | Имя обработки                                    |
+| ObjectName    | да           | —               | Имя объекта                                      |
 | TemplateName  | да           | —               | Имя макета                                       |
 | TemplateType  | да           | —               | Тип: HTML, Text, SpreadsheetDocument, BinaryData, DataCompositionSchema |
 | Synonym       | нет          | = TemplateName  | Синоним макета                                   |
 | SrcDir        | нет          | `src`           | Каталог исходников                               |
+| --SetMainSKD  | нет          | —               | Принудительно установить MainDataCompositionSchema |

 ## Команда

 ```powershell
-pwsh -NoProfile -File .claude/skills/epf-add-template/scripts/add-template.ps1 -ProcessorName "<ProcessorName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
+powershell.exe -NoProfile -File .claude\skills\template-add\scripts\add-template.ps1 -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
 ```

 ## Маппинг типов
@@ -58,10 +59,16 @@ pwsh -NoProfile -File .claude/skills/epf-add-template/scripts/add-template.ps1 -

 Если пользователь указал имя макета без префикса, но контекст — печатная форма, **добавь префикс `ПФ_MXL_` автоматически** и сообщи об этом.

+## MainDataCompositionSchema (авто)
+
+При добавлении макета типа `DataCompositionSchema` к `ExternalReport` или `Report`:
+- Если `MainDataCompositionSchema` пуст — автоматически заполняется ссылкой на макет
+- Используй `--SetMainSKD` чтобы перезаписать существующее значение
+
 ## Что создаётся

 ```
-<SrcDir>/<ProcessorName>/Templates/
+<SrcDir>/<ObjectName>/Templates/
 ├── <TemplateName>.xml              # Метаданные макета (1 UUID)
 └── <TemplateName>/
    └── Ext/
@@ -70,4 +77,5 @@ pwsh -NoProfile -File .claude/skills/epf-add-template/scripts/add-template.ps1 -

 ## Что модифицируется

- `<SrcDir>/<ProcessorName>.xml` — добавляется `<Template>` в конец `ChildObjects`
+- `<SrcDir>/<ObjectName>.xml` — добавляется `<Template>` в конец `ChildObjects`
+- Для ExternalReport/Report: может обновляться `MainDataCompositionSchema`
@@ -1,8 +1,9 @@
-# epf-add-template v1.0 — Add template to 1C processor
+# template-add v1.1 — Add template to 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
-	[string]$ProcessorName,
+	[Alias("ProcessorName")]
+	[string]$ObjectName,

 	[Parameter(Mandatory)]
 	[string]$TemplateName,
@@ -13,7 +14,9 @@ param(

 	[string]$Synonym = $TemplateName,

-	[string]$SrcDir = "src"
+	[string]$SrcDir = "src",
+
+	[switch]$SetMainSKD
 )

 $ErrorActionPreference = "Stop"
@@ -32,13 +35,13 @@ $tmpl = $typeMap[$TemplateType]

 # --- Проверки ---

-$rootXmlPath = Join-Path $SrcDir "$ProcessorName.xml"
+$rootXmlPath = Join-Path $SrcDir "$ObjectName.xml"
 if (-not (Test-Path $rootXmlPath)) {
 	Write-Error "Корневой файл обработки не найден: $rootXmlPath"
 	exit 1
 }

-$processorDir = Join-Path $SrcDir $ProcessorName
+$processorDir = Join-Path $SrcDir $ObjectName
 $templatesDir = Join-Path $processorDir "Templates"
 $templateMetaPath = Join-Path $templatesDir "$TemplateName.xml"

@@ -172,6 +175,36 @@ if ($childObjects.ChildNodes.Count -eq 0) {
 	}
 }

+# --- 4. MainDataCompositionSchema (для ExternalReport / Report) ---
+
+$mainDCSUpdated = $false
+if ($TemplateType -eq "DataCompositionSchema") {
+	# Определяем корневой элемент объекта
+	$reportLikeTypes = @("ExternalReport", "Report")
+	$objectTypeNode = $null
+	$objectTypeName = $null
+	foreach ($rt in $reportLikeTypes) {
+		$node = $xmlDoc.SelectSingleNode("//md:$rt", $nsMgr)
+		if ($node) {
+			$objectTypeNode = $node
+			$objectTypeName = $rt
+			break
+		}
+	}
+
+	if ($objectTypeNode) {
+		$mainDCS = $xmlDoc.SelectSingleNode("//md:${objectTypeName}/md:Properties/md:MainDataCompositionSchema", $nsMgr)
+		if ($mainDCS) {
+			$isEmpty = [string]::IsNullOrWhiteSpace($mainDCS.InnerText)
+			if ($isEmpty -or $SetMainSKD) {
+				$objName = $xmlDoc.SelectSingleNode("//md:${objectTypeName}/md:Properties/md:Name", $nsMgr).InnerText
+				$mainDCS.InnerText = "$objectTypeName.$objName.Template.$TemplateName"
+				$mainDCSUpdated = $true
+			}
+		}
+	}
+}
+
 # Сохранить с BOM
 $settings = New-Object System.Xml.XmlWriterSettings
 $settings.Encoding = $encBom
@@ -186,3 +219,6 @@ $stream.Close()
 Write-Host "[OK] Создан макет: $TemplateName ($TemplateType)"
 Write-Host "     Метаданные: $templateMetaPath"
 Write-Host "     Содержимое: $templateFilePath"
+if ($mainDCSUpdated) {
+	Write-Host "     MainDataCompositionSchema: $($mainDCS.InnerText)"
+}