---
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] [FormatVersion] [--with-skd]
```

| Параметр      | Обязательный | По умолчанию | Описание                              |
|---------------|:------------:|--------------|---------------------------------------|
| Name          | да           | —            | Имя отчёта (латиница/кириллица)       |
| Synonym       | нет          | = Name       | Синоним (отображаемое имя)            |
| SrcDir        | нет          | `src`        | Каталог исходников относительно CWD   |
| FormatVersion | нет          | `2.17`       | Версия формата выгрузки — см. ниже              |
| --WithSKD     | нет          | —            | Создать пустую СКД и привязать к MainDataCompositionSchema |

`FormatVersion` — **не выше** версии формата платформы, на которой объект будут собирать и открывать:
8.3.24 — `2.17`, 8.3.25 — `2.18`, 8.3.26 — `2.19`, 8.3.27 — `2.20`, 8.5 — `2.21`. Ниже брать можно:
платформа читает свой формат и любой более старый, поэтому дефолт `2.17` подходит для всей линейки
8.3.24 и выше. Для более старых платформ счёт идёт так же, по одной версии на релиз (8.3.23 — `2.16`),
но на них навыки не проверялись — такое значение принимается с предупреждением.

## Команда

```powershell
python ".codeassistant/skills/erf-init/scripts/init.py" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-FormatVersion "<версия>"] [-WithSKD]
```

## Дальнейшие шаги

- Добавить форму: `/form-add`
- Добавить макет: `/template-add`
- Добавить справку: `/help-add`
- Собрать ERF: `/erf-build`
