К основному содержанию
скилл CX Codex

template-add — скилл для Claude Code: создание макетов метаданных

Скилл template-add создаёт пустой макет заданного типа для объекта метаданных 1С и регистрирует его в корневом XML-файле конфигурации.

MIT 48 установок ★ 811 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Открыть на GitHub

Что делает template-add

Скилл генерирует структуру нового макета для отчётов, обработок, справочников или документов 1С. Поддерживаются форматы HTML, Text, SpreadsheetDocument, BinaryData и DataCompositionSchema.

Под капотом запускается PowerShell-скрипт add-template.ps1. Он формирует XML-описание макета, минимальный файл содержимого в каталоге <ObjectName>/Templates/<TemplateName> и прописывает узел <Template> в секцию ChildObjects основного XML объекта. Для отчётов со схемой компоновки инструмент может сразу заполнить MainDataCompositionSchema.

Для запуска скрипта в окружении требуется доступный powershell.exe. При создании табличных документов печатных форм скилл автоматически добавляет префикс ПФ_MXL_ к имени.

Какие задачи решает

  • создать пустую схему СКД для отчёта 1С
  • добавить табличный макет печатной формы в метаданные
  • зарегистрировать новый макет в корневом XML-файле объекта
  • создать файл двоичного или текстового макета обработки

Примеры запросов агенту

  • /template-add ОтчётПродажи ОсновнаяСхема DataCompositionSchema
  • /template-add ДополнительнаяОбработка АктСверки SpreadsheetDocument
  • /template-add Номенклатура Инструкция HTML

Как установить template-add

1Через маркетплейс плагинов

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

Команда ставит плагин 1c-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill template-add -a claude-code

3Вручную: положить файлы

~/.claude/skills/template-add/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/template-add/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о template-add

Как установить template-add в Claude Code?

Подключите каталог и установите пакет последовательными командами: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills и /plugin install 1c-skills@cc-1c-skills.

Что делает template-add?

Создаёт файлы макета нужного типа и вносит запись о нём в корневой XML-файл объекта конфигурации.

Что нужно для работы скилла?

В системе должен быть установлен PowerShell, так как вся логика генерации файлов выполняется через powershell.exe.

Исходный текст

SKILL.md · MIT
---
name: template-add
description: Добавить пустой макет к объекту 1С. Используй когда нужно создать у объекта новый макет
argument-hint: <ObjectName> <TemplateName> <TemplateType>
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
---

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

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

## Usage

```
/template-add <ObjectName> <TemplateName> <TemplateType>
```

| Параметр      | Обязательный | По умолчанию    | Описание                                         |
|---------------|:------------:|-----------------|--------------------------------------------------|
| ObjectName    | да           | —               | Имя объекта                                      |
| TemplateName  | да           | —               | Имя макета                                       |
| TemplateType  | да           | —               | Тип: HTML, Text, SpreadsheetDocument, BinaryData, DataCompositionSchema |
| Synonym       | нет          | = TemplateName  | Синоним макета                                   |
| Lang          | нет          | `ru`            | Код языка страницы — только для типа HTML. Повторный вызов с другим языком добавляет страницу в существующий макет |
| SrcDir        | нет          | `src`           | Путь к папке типа объектов (`Reports`, `DataProcessors`, `Catalogs`, `Documents`...), внутри которой лежит `<ObjectName>.xml`. Дефолт `src` подходит для каталогов с внешними обработками/отчётами, лежащими рядом |
| -SetMainSKD   | нет          | —               | Принудительно установить MainDataCompositionSchema |

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-Lang "<Lang>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
```

## Пример

Добавить основную СКД к отчёту в расширении:

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "ОтчётПродажи" -TemplateName "ОсновнаяСхемаКомпоновкиДанных" -TemplateType "DataCompositionSchema" -SrcDir "src/cfe/МоёРасширение/Reports"
```

## Маппинг типов

Пользователь может указать тип в свободной форме. Определи нужный по контексту:

| Пользователь пишет                          | TemplateType        | Расширение | Содержимое              |
|---------------------------------------------|---------------------|------------|-------------------------|
| HTML                                        | HTMLDocument        | `Template/<lang>.html` | Пустой HTML-документ |
| Text, текстовый документ, текст             | TextDocument        | `.txt`     | Пустой файл             |
| SpreadsheetDocument, табличный документ, MXL | SpreadsheetDocument | `.xml`     | Минимальный spreadsheet |
| BinaryData, двоичные данные                 | BinaryData          | `.bin`     | Пустой файл             |
| DataCompositionSchema, СКД, схема компоновки | DataCompositionSchema | `.xml`   | Минимальная DCS-схема   |

## Конвенция именования

Для макетов **печатных форм** (тип SpreadsheetDocument) применяй префикс `ПФ_MXL_`:

| Контекст                                                         | Формат имени               | Пример                  |
|------------------------------------------------------------------|----------------------------|-------------------------|
| Печатная форма (дополнительная обработка вида ПечатнаяФорма, или пользователь явно говорит «печатная форма») | `ПФ_MXL_<КраткоеИмя>`     | `ПФ_MXL_М11`, `ПФ_MXL_СчётФактура`, `ПФ_MXL_КонвертDL` |
| Прочие макеты (загрузка данных, служебные, настройки)            | Без префикса               | `МакетЗагрузки`, `НастройкиПечати` |

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

## MainDataCompositionSchema (авто)

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

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

```
<SrcDir>/<ObjectName>/Templates/
├── <TemplateName>.xml              # Метаданные макета (1 UUID)
└── <TemplateName>/
    └── Ext/
        ├── Template.<ext>          # Содержимое макета
        └── Template/<lang>.html    # HTML: содержимое (Template.xml — дескриптор)
```

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

- `<SrcDir>/<ObjectName>.xml` — добавляется `<Template>` в `ChildObjects`
- Для ExternalReport/Report: может обновляться `MainDataCompositionSchema`

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Похожие скиллы

Всё по теме «1С» →
pr-reference microsoft Скилл pr-reference для Claude Code собирает коммиты и дифы между ветками в структурированный XML. Данные используются для описания PR, code review и анализа изменений в проекте. CX Codex +1 ★ 1 627звёзд репо price-check ilyautov Скилл price-check считает валовую маржу по товарам и строит три сценарных среза цены — текущая, рост и снижение — с учётом статуса НДС. Расчёт маржи ведёт через процесс скилла margin-analyzer. CX Codex +1 ★ 38звёзд репо month-end-prep ilyautov Скилл month-end-prep проводит собственника через закрытие месяца: сверяет данные 1С/МойСклад с зачислениями эквайринга и банком, находит операции без статьи, дубли и пропавшую первичку, затем пишет ОПиУ-сводку и выгружает xlsx с PDF. CX Codex +1 ★ 38звёзд репо 1c-rest-mcp theYahia MCP-сервер 1c-rest-mcp подключает ИИ-агента к данным 1С через OData 3.0. Подходит для чтения и изменения каталогов, документов и регистров. CX Codex +1 ★ 13звёзд репо Yzel — 1C:Enterprise Aiyo28 Yzel — 1C:Enterprise — MCP-сервер для Claude Code, который подключает AI-ассистента к базам 1С:Предприятие через OData v3. Работает с локальными инсталляциями и 1С:Fresh. CX Codex +1 ★ 9звёзд репо recipe-create-doc-from-template официальный googleworkspace Скилл recipe-create-doc-from-template для Claude Code копирует шаблон Google Docs, вставляет текст и настраивает доступ коллегам через CLI. Создаёт типовые отчёты и брифы. CX Codex +1 31 800установок

Из того же набора81

Весь набор →
meta-validate Скилл meta-validate проверяет XML объектов метаданных 1С на структурные ошибки после создания или изменения конфигурации. CX Codex +1 49установок form-validate Скилл form-validate запускает валидацию управляемой формы 1С после создания или изменения, чтобы найти ошибки в структуре. CX Codex +1 49установок epf-init Скилл epf-init разворачивает XML-исходники новой внешней обработки 1С с метаданными и структурой каталогов. Пригодится при старте разработки EPF с нуля. CX Codex +1 49установок cf-info Скилл cf-info для Claude Code разбирает структуру конфигурации 1С: показывает свойства, состав и счётчики объектов. Запускается для обзора выгрузки или подробностей по разделу. CX Codex +1 49установок meta-info Скилл meta-info разбирает выгрузку объектов 1С в XML и выводит компактную структуру реквизитов, табличных частей и движений без ручного чтения сырых файлов. CX Codex +1 48установок cfe-borrow Скилл cfe-borrow для Claude Code переносит объекты основной конфигурации 1С в расширение CFE. Позволяет изменять формы, добавлять реквизиты и перехватывать методы через заимствование. CX Codex +1 48установок template-remove Скилл template-remove для Claude Code удаляет макет из объекта 1С и снимает его регистрацию в корневом XML. Удаляет макеты из обработок, отчётов и справочников. CX Codex +1 47установок skd-validate Скилл skd-validate проверяет XML-макеты схемы компоновки данных 1С на битые ссылки, порядок тегов и дубликаты имён. CX Codex +1 47установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой