fix(xdto-compile,xdto-validate): не терять конструкции молча; вычитать инструкции

xdto-compile терял свойства без единого слова: на реалистичной чужой схеме
из шести объявленных доезжало одно. Вложенные xs:sequence/xs:choice теперь
уплощаются (модель хранит плоский список), xs:all трактуется как
последовательность, xs:group и xs:attributeGroup раскрываются по ссылке —
и о каждом приближении навык пишет предупреждение. Молчаливая потеря — тот же
класс дефекта, что мы ловим у платформы, лечится так же: сообщением, не отказом.

xdto-validate получил проверки на грабли, найденные при разработке: порядок
элементов верхнего уровня (платформа отвергает пакет, не называя причины),
конфликты объявлений (name+ref, type+вложенный тип, тип без разновидности),
несовпадение рода базового типа, дубли имён свойств.

Новые правила прогнаны по всем 760 пакетам выгрузок: всё, что породила
платформа, валидно по определению, поэтому каждая ошибка там — ошибка правила.
Первый прогон дал 7, и все три класса оказались реальным поведением платформы:
length вместе с minLength/maxLength встречается, два пакета делят один
targetNamespace (Envelope и SOAP_Envelope_1_1 в БП), form="Text" называется
не только __content. Правила понижены до предупреждений либо сняты. Заодно
убран шум: предупреждение о неиспользуемом import срабатывало на четверти
корпуса — теперь только вместе с anyType, где оно и означает проблему.
Итог: 0 ошибок на корпусе, предупреждений 53 вместо 242.

Инструкции переписаны под читателя-исполнителя: убраны детали реализации
и наши мерки, каталог проверок валидатора (его вывод самодостаточен),
локальные пути в примерах заменены нейтральными. Таблица соответствий
XSD и справочник аннотаций вынесены в xdto-compile/xsd-reference.md.

Round-trip 760/760 сохранён, паритет PS/PY сохранён.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.claude/skills/xdto-compile/xsd-reference.md

@@ -0,0 +1,88 @@
+# XSD ↔ XDTO — справочник
+
+## Соответствия
+
+| XML Schema | Модель XDTO |
+|---|---|
+| `xs:schema/@targetNamespace` | пространство имён пакета |
+| `elementFormDefault` / `attributeFormDefault` | `elementFormQualified` / `attributeFormQualified` |
+| `xs:import/@namespace` | зависимость от другого пакета (разрешается по namespace) |
+| `xs:complexType` | объектный тип |
+| `xs:simpleType` | тип значения |
+| `xs:element` / `xs:attribute` на верхнем уровне | глобальное свойство пакета |
+| `xs:element` / `xs:attribute` внутри типа | свойство типа |
+| `@minOccurs` / `@maxOccurs="unbounded"` | `lowerBound` / `upperBound="-1"` |
+| `@nillable`, `@default`, `@fixed`, `@ref` | те же по смыслу |
+| анонимный `xs:simpleType`/`xs:complexType` в объявлении | встроенный тип свойства |
+| `xs:complexContent/xs:extension/@base` | наследование типа |
+| `@abstract`, `@mixed` | те же |
+| `xs:choice` | тип-выбор одного из вариантов |
+| `xs:any` + `xs:anyAttribute` | открытый тип |
+| `xs:simpleContent/xs:extension/@base` | свойство собственного значения элемента |
+| `xs:restriction` + фасеты | базовый тип + ограничения |
+| `xs:pattern`, `xs:enumeration` | те же |
+| `xs:list/@itemType` | список |
+| `xs:union/@memberTypes` | объединение |
+
+Порядок объявлений верхнего уровня в XSD произвольный — навык сам расставит их
+в порядке, который требует модель.
+
+## Аннотации `xdto:`
+
+Пространство имён — `http://v8.1c.ru/8.1/xdto`. Нужны только там, где XML Schema
+не может выразить то, что умеет модель. В большинстве схем не нужны вовсе.
+
+Правило: **чего XSD сказать не может — пиши атрибутом `xdto:` с тем же именем,
+что и в модели**.
+
+| Аннотация | Где | Назначение |
+|---|---|---|
+| `xdto:nillable` | `xs:attribute` | `nillable` у свойства-атрибута (XSD допускает только у элементов) |
+| `xdto:lowerBound`, `xdto:upperBound` | `xs:attribute` | кратность свойства-атрибута |
+| `xdto:qualified` | объявление | переопределение `*FormQualified` для одного свойства |
+| `xdto:name` | объявление | имя свойства, если XML-имя не годится как идентификатор 1С; XML-имя уйдёт в `localName` |
+| `xdto:form` | `xs:element` | записать `form` явно |
+| `xdto:variety` | `xs:restriction`, `xs:list`, `xs:union` | записать разновидность типа явно |
+| `xdto:open`, `xdto:abstract`, `xdto:mixed`, `xdto:ordered`, `xdto:sequenced` | `xs:complexType` | флаги типа, не выводимые из модели содержимого |
+| `xdto:order` | `xs:complexType` | исходный порядок свойств, если он не «атрибуты первыми»; имена через `\|` |
+| `xdto:textName`, `xdto:textlowerBound`, `xdto:textupperBound`, `xdto:textnillable` | `xs:extension` в `xs:simpleContent` | параметры свойства собственного значения |
+| `xdto:type` | `xs:enumeration` | тип литерала перечисления |
+| `xdto:prefix` | объявление | осмысленный префикс пространства имён вместо генерируемого |
+| `xdto:memberTypesForm="prefixed"` | `xs:union` | записать состав объединения префиксами, а не `{ns}имя` |
+| `xdto:declareNs` | `xs:union` | объявить префикс пространства имён на узле |
+| `xdto:elementFormQualified`, `xdto:attributeFormQualified` | `xs:schema` | записать флаги явно |
+
+Пример:
+
+```xml
+<xs:complexType name="КонтактнаяИнформация" xdto:sequenced="true">
+    <xs:sequence>
+        <xs:element name="Комментарий" type="xs:string" minOccurs="0"/>
+        <xs:element name="Адрес по документу" type="xs:string"
+                    xdto:name="Адрес_по_документу" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="Представление" type="xs:string"
+                  xdto:nillable="true" xdto:lowerBound="0"/>
+</xs:complexType>
+```
+
+Аннотации, которые проставляет `/xdto-decompile` при выгрузке существующего пакета,
+писать вручную не нужно — они нужны, чтобы обратная сборка вернула ровно тот же файл.
+
+## Свойства объекта метаданных
+
+```xml
+<xs:annotation>
+    <xs:appinfo>
+        <xdto:package xmlns:xdto="http://v8.1c.ru/8.1/xdto">
+            <xdto:name>ОбменСБанком</xdto:name>
+            <xdto:synonym lang="ru">Обмен с банком</xdto:synonym>
+            <xdto:synonym lang="en">Bank exchange</xdto:synonym>
+            <xdto:comment>Формат 1С:Предприятие — Клиент банка</xdto:comment>
+        </xdto:package>
+    </xs:appinfo>
+</xs:annotation>
+```
+
+Пространство имён пакета берётся из `targetNamespace` и здесь не дублируется.
+Параметры `-Name`, `-Synonym`, `-Comment` имеют приоритет над этим блоком.