template-add
Добавить пустой макет к объекту 1С. Используй когда нужно создать у объекта новый макет
How do I install this agent skill?
npx skills add https://github.com/nikolay-shirokov/cc-1c-skills --skill template-addIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill automates the addition of templates to 1C:Enterprise objects by creating directories and modifying XML project files. It includes security features like a support guard to prevent accidental modification of vendor-locked objects and validation of language codes to ensure filesystem compatibility.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
/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.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-Lang "<Lang>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
Пример
Добавить основную СКД к отчёту в расширении:
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nikolay-shirokov/cc-1c-skills/template-add">View template-add on skillZs</a>