xdto-validate — скилл для Claude Code: что делает и как установить
Скилл xdto-validate проводит статическую проверку пакетов XDTO 1С перед загрузкой в конфигурацию. Находит неразрешённые типы и ошибки связей метаданных.
MIT 36 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает xdto-validate
Скилл запускает скрипт xdto-validate.ps1 через powershell.exe, чтобы проверить модель пакета XDTO, файл метаданных и привязку к исходникам 1С. Каждая найденная неполадка выводится отдельной строкой с маркером [ERROR] или [WARN]. При критических ошибках процесс завершается с кодом 1.
Статическая валидация нужна потому, что платформа 1С способна принять повреждённый пакет без предупреждений. Если тип из чужого пространства имён не найден, платформа молча заменит его на xs:anyType, а ФабрикаXDTO вернёт нетипизированное значение уже во время исполнения кода.
Скрипт принимает путь к каталогу, файлу Ext/Package.bin или XML-описанию через параметр PackagePath. По умолчанию проверка останавливается после 20 ошибок, если не переопределить MaxErrors. Без установленного PowerShell в окружении проверка пакета не запустится.
Какие задачи решает
- найти неразрешённые типы пространств имён до загрузки пакета в базу
- проверить корректность связи объекта метаданных с исходниками конфигурации
- сохранить детальный отчёт о дефектах пакета XDTO в файл через
OutFile - предотвратить подмену типов на
xs:anyTypeпри работе черезФабрикаXDTO
Примеры запросов агенту
- /xdto-validate PackagePath "src/XDTOpackages/OrderExchange"
- /xdto-validate PackagePath "Ext/Package.bin" -Detailed -OutFile "xdto_report.txt"
- /xdto-validate PackagePath "Order.xml" -ConfigDir "src/cf" -MaxErrors 5
Как установить xdto-validate
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-validate -a claude-code3Вручную: положить файлы
~/.claude/skills/xdto-validate/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/xdto-validate/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-validate -a codex2Вручную: положить файлы
.agents/skills/xdto-validate/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-validate -a cursor2Вручную: положить файлы
.cursor/skills/xdto-validate/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/xdto-validate2Вручную: положить файлы
.github/skills/xdto-validate/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-validate -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/xdto-validateВручную: положить файлы
.devin/skills/xdto-validate/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о xdto-validate
Как установить xdto-validate в Claude Code?
Выполните в Claude Code команду /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, а затем установите пакет вызовом /plugin install 1c-skills@cc-1c-skills.
Что делает xdto-validate?
Проверяет модель пакета XDTO и корректность метаданных до загрузки в базу 1С, сигнализируя о критических ошибках кодом возврата 1.
Зачем запускать валидацию, если пакет успешно загружается в 1С?
Платформа 1С способна молча заменить отсутствующие типы на xs:anyType, из-за чего ошибка проявится только во время исполнения при обращении к объектам через фабрику.
Исходный текст
SKILL.md · MIT
---
name: xdto-validate
description: Валидация пакета XDTO 1С. Используй после создания или модификации пакета XDTO для проверки корректности
argument-hint: <PackagePath> [-ConfigDir <каталог>] [-Detailed] [-MaxErrors N] [-OutFile <файл>]
allowed-tools:
- Bash
- Read
- Glob
---
# /xdto-validate — Валидация пакета XDTO
Проверяет модель пакета, объект метаданных и его связь с конфигурацией.
Каждая находка выводится отдельной строкой с объяснением. Exit code `1` при ошибках.
## Параметры
| Параметр | Обязательный | Описание |
|----------|--------------|----------|
| `PackagePath` | да | Каталог пакета, `Ext/Package.bin` или `<Имя>.xml` объекта метаданных. Псевдоним — `-Path` |
| `ConfigDir` | нет | Корень исходников. По умолчанию определяется по расположению пакета |
| `Detailed` | нет | Показывать успешные проверки, а не только проблемы |
| `MaxErrors` | нет | Остановиться после N ошибок. По умолчанию 20 |
| `OutFile` | нет | Записать отчёт в файл |
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-validate.ps1" -PackagePath "<путь>"
```
`[ERROR]` — платформа такой пакет не примет либо примет неправильно.
`[WARN]` — пакет рабочий, но есть риск, о котором стоит знать.
## Зачем запускать, если пакет и так грузится
Часть дефектов платформа не диагностирует: неразрешённый тип из чужого пространства
имён она молча подменяет на `xs:anyType`, и пакет выглядит загруженным, пока
`ФабрикаXDTO` не отдаст в рантайме бесструктурное значение. Такие вещи видно только
статически — до загрузки в базу.
## Типичный workflow
1. `/xdto-compile`, `/xdto-edit` или переработка через `/xdto-decompile` → `/xdto-compile -Force`
2. `/xdto-validate <путь>` — до загрузки в базу
3. `/db-load-xml` + `/db-update`
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills