creator/cc-1c-skills
1
0
Fork 0
mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-09-17 15:25:23 +03:00
Code Issues Packages Projects Releases Wiki Activity

docs(xdto-compile,xdto-decompile,xdto-validate): обязательность параметров и умолчания

Browse Source 
В таблицах параметров не было видно, что обязательно, а что нет, и какие
значения подставляются по умолчанию. Добавлена колонка «Обязательный»
(по образцу form-edit), умолчания расписаны, отмечена взаимоисключающая
пара -XsdPath/-Xsd, псевдонимы -Path и поведение без -Force.

Сверил документацию с поведением скриптов: хеш-таблица в -Synonym работает
только в PS-порте, в Python её нет — из инструкции убрана, многоязычный
синоним задаётся блоком xs:appinfo, который поддерживают оба порта.

Убран последний след нашего обсуждения формата («отдельного DSL нет» —
читателю не с чем сравнивать), добавлено, где посмотреть уже собранные
пакеты, и точное имя файла справочника аннотаций.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-07-26 10:46:59 +03:00
co-authored by Claude Opus 5
parent 7ca6dfa6b2
commit 0aa9342407
3 changed files with 31 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/xdto-decompile/SKILL.md
+8 -8
View File
@@ -15,10 +15,10 @@ allowed-tools:
## Параметры
| Параметр | Описание |
|----------|----------|
| `PackagePath` | Каталог пакета, путь к `Ext/Package.bin` или к `<Имя>.xml` объекта метаданных |
| `OutFile` | Записать схему в файл. Без него — вывод в stdout |
| Параметр | Обязательный | Описание |
|----------|--------------|----------|
| `PackagePath` | да | Каталог пакета, путь к `Ext/Package.bin` или к `<Имя>.xml` объекта метаданных. Псевдоним — `-Path` |
| `OutFile` | нет | Записать схему в файл (UTF-8 с BOM). Без него — вывод в stdout |
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-decompile.ps1" -PackagePath "<путь>"
@@ -40,13 +40,13 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-decompile.ps1"
В схеме могут встретиться атрибуты с префиксом `xdto:` — так записано то, что
XML Schema выразить не может (например `nillable` у атрибута). Схема при этом остаётся
валидной, валидаторы такие атрибуты игнорируют. Трогать их обычно не нужно; смысл
каждого описан в справочнике навыка `/xdto-compile`.
каждого описан в `xsd-reference.md` навыка `/xdto-compile`.
## Передача схемы наружу
Полученную XSD можно отдавать контрагенту как есть. В отличие от команды
«Экспорт XML-схемы» в Конфигураторе, навык не теряет `nillable` у свойств-атрибутов
и не пишет `form` на глобальных объявлениях, где спецификация XSD его не допускает.
Полученную XSD можно отдавать контрагенту как есть — она валидна и не теряет
данных пакета. Штатная команда «Экспорт XML-схемы» в Конфигураторе для этого
хуже: она теряет `nillable` у свойств-атрибутов.
## Верификация