xdto-info — скилл для Claude Code: анализ XDTO и установка
Скилл xdto-info разбирает пакеты XDTO 1С, типы, свойства и точки входа. Пригодится перед созданием XDTO-объекта или разбором входящего XML.
MIT 35 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает xdto-info
Скилл показывает структуру XDTO в терминах 1С: тип значения, обязательность свойства, вложенные объекты, коллекции и допустимые значения перечислений. Он также помогает найти пакеты в конфигурации и понять, какие типы ссылаются друг на друга.
Точкой входа служит каталог пакета или корень исходников конфигурации. Параметры -Namespace, -Package и -Name уточняют поиск, -Depth раскрывает вложенные объекты, а -RequiredOnly оставляет обязательные свойства. Режим -Mode used-by показывает ссылки на тип; -Limit, -Offset и -OutFile управляют выводом.
Команда запускает PowerShell-скрипт xdto-info.ps1, поэтому для работы нужен доступ к каталогу пакета или исходникам конфигурации. Результат можно записать в файл UTF-8 BOM.
Какие задачи решает
- найти пакеты XDTO в исходниках конфигурации
- разобрать тип перед заполнением объекта 1С
- определить обязательные свойства и вложенные объекты
- найти типы, ссылающиеся на выбранный тип
- сохранить структуру пакета в файл
Примеры запросов агенту
- Покажи все пакеты XDTO в каталоге
srcкомандой/xdto-info src. - Разбери тип
ПлатежныйДокументв пакете с пространством имёнurn:1C.ru:ClientBankExchangeна глубину3. - Покажи, кто использует тип
СуммаТип, через режим-Mode used-by.
Как установить xdto-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 xdto-info -a claude-code3Вручную: положить файлы
~/.claude/skills/xdto-info/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/xdto-info/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-info -a codex2Вручную: положить файлы
.agents/skills/xdto-info/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-info -a cursor2Вручную: положить файлы
.cursor/skills/xdto-info/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/xdto-info2Вручную: положить файлы
.github/skills/xdto-info/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-info -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/xdto-infoВручную: положить файлы
.devin/skills/xdto-info/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о xdto-info
Как установить xdto-info в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем установите плагин командой /plugin install 1c-skills@cc-1c-skills.
Что делает xdto-info?
Скилл разбирает пакеты XDTO 1С и показывает типы, свойства, обязательность, вложенные объекты, точки входа и допустимые значения.
Что нужно передать xdto-info для работы?
Укажите PackagePath: каталог пакета или корень исходников конфигурации. Пакет и тип можно уточнить через -Namespace, -Package и -Name.
Исходный текст
SKILL.md · MIT
---
name: xdto-info
description: Анализ структуры пакета XDTO 1С — типы, свойства, точки входа. Используй как подготовительный шаг при написании кода, создающего и заполняющего объект XDTO, при разборе входящего XML, а также чтобы узнать, какие пакеты есть в конфигурации
argument-hint: <PackagePath> [-Namespace <URI>|-Package <имя>] [-Name <Тип>] [-Depth N] [-RequiredOnly] [-Mode used-by] [-Limit N] [-Offset N] [-OutFile <файл>]
allowed-tools:
- Bash
- Read
- Glob
---
# /xdto-info — Анализ структуры пакета XDTO
Показывает структуру типа в терминах 1С: какой тип значения присваивать, что обязательно,
где нужен вложенный объект, какие значения допустимы. Заменяет чтение `Package.bin`
или XSD с ручным переводом `xs:decimal` → `Число` и `lowerBound="0"` → необязательный.
## Параметры
| Параметр | Обязательный | Описание |
|----------|--------------|----------|
| `PackagePath` | да | Каталог пакета либо корень исходников конфигурации. Псевдоним — `-Path` |
| `Namespace` | нет | Выбрать пакет по пространству имён (когда путь — корень исходников) |
| `Package` | нет | Выбрать пакет по имени объекта метаданных |
| `Name` | нет | Имя типа. Без выбранного пакета ищется по всей конфигурации |
| `Depth` | нет | Глубина разузлования вложенных объектов. По умолчанию 1 |
| `RequiredOnly` | нет | Оставить только обязательные свойства — скелет для «заполни обязательное». Необязательный объект уходит вместе со своим содержимым |
| `Mode` | нет | `used-by` — показать, кто ссылается на тип |
| `Limit` / `Offset` | нет | Пагинация. По умолчанию 150 строк |
| `OutFile` | нет | Записать результат в файл (UTF-8 BOM) |
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-info.ps1" -PackagePath "<путь>"
```
## Что показывает
Точка входа определяется по пути: корень исходников — список пакетов, каталог пакета —
его состав.
| Вызов | Результат |
|---|---|
| `-PackagePath src` | все пакеты конфигурации: имя, число типов, namespace |
| `-PackagePath src/XDTOPackages/ОбменСБанком` | импорты, точки входа, списки типов |
| `... -Name ПлатежныйДокумент` | структура типа для заполнения |
| `... -Name ПлатежныйДокумент -Depth 3` | то же с раскрытием вложенных объектов |
| `... -Mode used-by -Name СуммаТип` | кто ссылается на тип, включая соседние пакеты |
## Когда известны namespace и тип, но не имя пакета
Так бывает чаще всего: namespace и имя типа видны в коде или в образце XML,
а как называется пакет — нет. Вызов повторяет строку, от которой отталкиваешься:
```powershell
# ФабрикаXDTO.Тип("urn:1C.ru:ClientBankExchange", "ПлатежныйДокумент")
... -PackagePath src -Namespace "urn:1C.ru:ClientBankExchange" -Name ПлатежныйДокумент
```
Если известно только имя типа — укажи `-Name` и корень исходников: тип найдётся
по всем пакетам. При нескольких совпадениях навык покажет, где именно, чтобы уточнить.
## Что в выводе
Свойства показаны так, как их предстоит заполнять в коде: тип значения — в нотации
1С и с учётом ограничений (`Строка(6)`, `Число(18,2)`), обязательность и коллекции —
флагами, для перечислимых типов перечислены допустимые значения. Непомеченное
свойство необязательно.
Обозначения, которые сами по себе неочевидны, навык поясняет прямо в выводе —
и только те, что в нём встретились.
## Типичный workflow
1. `/xdto-info src` — какие пакеты есть
2. `/xdto-info src -Namespace "<URI>"` — точки входа и типы пакета
3. `/xdto-info src -Namespace "<URI>" -Name <Тип> -Depth 2` — структура для кода
4. Перед правкой типа: `-Mode used-by -Name <Тип>` — кого затронет
Нужна сама XML-схема, а не сводка, — это `/xdto-decompile`.
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills