mxl-info — скилл для Claude Code: анализ MXL и установка
Скилл mxl-info разбирает структуру макета табличного документа MXL и показывает области с параметрами. Пригодится при разработке печатных форм в 1С.
MIT 46 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает mxl-info
mxl-info читает Template.xml и собирает сводку по именованным областям, параметрам, наборам колонок и их пересечениям. Области идут сверху вниз, как в документе. При разработке печатной формы так проще понять, какие области и параметры нужно заполнять в коде 1С.
Скилл запускает PowerShell-скрипт mxl-info.ps1: передайте ему путь через -TemplatePath либо укажите вместе -ProcessorName и -TemplateName. По умолчанию вывод текстовый; флаг -WithText добавляет надписи и шаблонные строки, а -Format json задаёт JSON-формат. Для запуска нужна команда powershell.exe; без пути или обеих частей имени макета скрипту не с чем работать.
Какие задачи решает
- найти именованные области в
Template.xml - составить список параметров для каждой области
- проверить пересечения областей строк и колонок
- вывести текст ячеек и шаблонные подстановки
- получить сводку в JSON для обработки скриптом
Примеры запросов агенту
- Проанализируй макет
Template.xmlпо путиsrc/Документы/Счёт/Template.xmlи перечисли области с параметрами. - Запусти
/mxl-info <TemplatePath>для макета по путиsrc/Документы/Счёт/Template.xmlи покажи текст ячеек. - Выполни
/mxl-info <ProcessorName> <TemplateName>для обработкиПечатьСчётаи макетаОсновной, выведи результат в JSON.
Как установить mxl-info
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 mxl-info -a claude-code3Вручную: положить файлы
~/.claude/skills/mxl-info/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mxl-info/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-info -a codex2Вручную: положить файлы
.agents/skills/mxl-info/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-info -a cursor2Вручную: положить файлы
.cursor/skills/mxl-info/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/mxl-info2Вручную: положить файлы
.github/skills/mxl-info/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-info -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/mxl-infoВручную: положить файлы
.devin/skills/mxl-info/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mxl-info
Как установить mxl-info в Claude Code?
В Claude Code выполни команды по порядку: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills.
Что делает mxl-info?
Читает Template.xml и выводит области макета, параметры и наборы колонок. Опция -WithText добавляет статические надписи и шаблонные строки.
Что передать mxl-info для поиска макета?
Укажи -TemplatePath с путём к файлу либо передай оба параметра: -ProcessorName и -TemplateName. Для поиска по имени исходный каталог задаётся через -SrcDir.
Исходный текст
SKILL.md · MIT
---
name: mxl-info
description: Анализ структуры макета табличного документа (MXL) — области, параметры, наборы колонок. Используй при разработке печати — получить области и заполняемые параметры макета
argument-hint: <TemplatePath> или <ProcessorName> <TemplateName>
allowed-tools:
- Bash
- Read
- Glob
---
# /mxl-info — Анализ структуры макета
Читает Template.xml табличного документа и выводит компактную сводку: именованные области, параметры, наборы колонок. Заменяет необходимость читать тысячи строк XML.
## Использование
```
/mxl-info <TemplatePath>
/mxl-info <ProcessorName> <TemplateName>
```
## Параметры
| Параметр | Обязательный | По умолчанию | Описание |
|---------------|:------------:|--------------|------------------------------------------|
| TemplatePath | нет | — | Прямой путь к Template.xml |
| ProcessorName | нет | — | Имя обработки (альтернатива пути) |
| TemplateName | нет | — | Имя макета (альтернатива пути) |
| SrcDir | нет | `src` | Каталог исходников |
| Format | нет | `text` | Формат вывода: `text` или `json` |
| WithText | нет | false | Включить статический текст и шаблоны |
| MaxParams | нет | 10 | Макс. параметров в списке на область |
| Limit | нет | 150 | Макс. строк вывода (защита от переполнения) |
| Offset | нет | 0 | Пропустить N строк (для пагинации) |
Укажите либо `-TemplatePath`, либо оба `-ProcessorName` и `-TemplateName`.
## Команда
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -TemplatePath "<путь>"
```
Или по имени обработки/макета:
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
```
Дополнительные флаги:
```powershell
... -WithText # включить текстовое содержимое ячеек
... -Format json # JSON-вывод для программной обработки
... -MaxParams 20 # показать больше параметров на область
... -Offset 150 # пагинация: пропустить первые 150 строк
```
## Чтение вывода
### Области — сортировка сверху вниз
Области перечислены в порядке документа (по позиции строки), а не по алфавиту. Это соответствует порядку вывода областей в коде заполнения — сверху вниз.
```
--- Named areas ---
Заголовок Rows rows 1-4 (1 params)
Поставщик Rows rows 5-6 (1 params)
Строка Rows rows 14-14 (8 params)
Итого Rows rows 16-17 (1 params)
```
Типы областей:
- **Rows** — горизонтальная область (диапазон строк). Получение: `Макет.ПолучитьОбласть("Имя")`
- **Columns** — вертикальная область (диапазон колонок). Получение: `Макет.ПолучитьОбласть("Имя")`
- **Rectangle** — фиксированная область (строки + колонки). Обычно использует отдельный набор колонок.
- **Drawing** — именованный рисунок/штрихкод.
### Пересечения
Когда есть области и Rows, и Columns (этикетки, ценники), скрипт выводит пары пересечений:
```
--- Intersections (use with GetArea) ---
ВысотаЭтикетки|ШиринаЭтикетки
```
В BSL: `Макет.ПолучитьОбласть("ВысотаЭтикетки|ШиринаЭтикетки")`
### Параметры и detailParameter
Параметры перечислены по областям. Если у параметра есть `detailParameter` (расшифровка), он показан ниже:
```
--- Parameters by area ---
Поставщик: ПредставлениеПоставщика
detail: ПредставлениеПоставщика->Поставщик
Строка: НомерСтроки, Товар, Количество, Цена, Сумма, ... (+3)
detail: Товар->Номенклатура
```
Это означает: параметр `Товар` отображает значение, а при клике открывает `Номенклатура` (объект расшифровки).
### Параметры из шаблонов (суффикс `[tpl]`)
Некоторые параметры встроены в шаблонный текст: `"Инв № [ИнвентарныйНомер]"`. Они заполняются через fillType=Template, а не fillType=Parameter. Скрипт всегда извлекает их и помечает суффиксом `[tpl]`:
```
НумерацияЛистов: Номер [tpl], Дата [tpl], НомерЛиста [tpl]
```
В BSL шаблонные параметры заполняются так же, как обычные:
```bsl
Область.Параметры.Номер = НомерДокумента;
Область.Параметры.Дата = ДатаДокумента;
```
Числовые подстановки вроде `[5]`, `[6]` (ссылки на сноски в официальных формах) игнорируются.
### Текстовое содержимое (`-WithText`)
Показывает статический текст (надписи, заголовки) и шаблонные строки с подстановками `[Параметр]`:
```
--- Text content ---
ШапкаТаблицы:
Text: "№", "Товар", "Ед. изм.", "Кол-во", "Цена", "Сумма"
Строка:
Templates: "Инв № [ИнвентарныйНомер]"
```
- **Text** — статические надписи (fillType=Text). Полезно для понимания назначения колонок.
- **Templates** — текст с подстановками `[ИмяПараметра]` (fillType=Template). Параметр внутри `[]` заполняется программно.
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills