docs(v8-xsd-fetch): инструкция только про применение

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018dc2yLQfw6wppbopM1Y4Ps
This commit is contained in:
Nick Shirokov
2026-09-29 13:57:06 +03:00
co-authored by Claude Opus 5.5
parent 1ef99d1b03
commit fa77c8b74d
+12 -20
View File
@@ -9,36 +9,28 @@ allowed-tools:
# /v8-xsd-fetch — XSD-схемы платформы # /v8-xsd-fetch — XSD-схемы платформы
Скачивает XSD-схемы формата выгрузки из репозитория Скачивает XSD-схемы формата выгрузки по версиям формата в каталог схем проекта
[yellow-hammer/namespace-forest](https://github.com/yellow-hammer/namespace-forest) (`.v8-xsd` рядом с `.v8-project.json` или путь из его ключа `xsdPath`).
и раскладывает по версиям формата: `.v8-xsd/<версия>/*.xsd`. По этим схемам навыки
проверяют выгрузку без базы; нет схем — нет проверки.
## Команда ## Команда
```powershell ```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/v8-xsd-fetch.ps1" [-Versions "2.20,2.21"] [-List] powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/v8-xsd-fetch.ps1" -Versions "2.20"
``` ```
| Параметр | Описание | | Параметр | Описание |
|----------|----------| |----------|----------|
| `-Versions "<список>"` | Версии формата через запятую. Без него — все доступные (около 600 КБ на версию) | | `-Versions "<список>"` | Версии формата через запятую. Без него — все доступные (около 600 КБ на версию) |
| `-List` | Показать доступные версии и какие уже есть локально, ничего не скачивая | | `-List` | Показать доступные версии и какие уже скачаны, ничего не скачивая |
| `-OutPath <путь>` | Каталог схем, если нужен не тот, что в проекте | | `-OutPath <путь>` | Другой каталог схем — только если пользователь его назвал |
| `-Force` | Перекачать файлы, которые уже есть | | `-Force` | Перекачать уже скачанные файлы |
| `-Ref <ветка/коммит>` | Состояние репозитория-источника, по умолчанию `main` |
## Куда кладёт
`-OutPath` → `xsdPath` из `.v8-project.json` (относительно файла) → `.v8-xsd` рядом с
`.v8-project.json` → `.v8-xsd` в текущем каталоге.
Рядом со схемами — `README.md` (что это и откуда) и `source.json` (репозиторий, коммит, дата).
Схемы — собственность ООО «1С-Софт»: каталог в Git не добавлять, его место в `.gitignore`.
## Какую версию брать ## Какую версию брать
Версия формата — атрибут `version` корня `Configuration.xml` выгрузки (например, `2.20`), Версия формата — атрибут `version` корня `Configuration.xml` выгрузки (например, `2.20`), а не номер
а не номер релиза платформы. Достаточно версий тех выгрузок, с которыми работает проект. релиза платформы. Скачивай версии выгрузок, с которыми работает проект.
Без сети: скопировать каталоги `schemas/designer/<версия>/` из репозитория-источника вручную. Каталог схем в Git не добавляй: если проект — репозиторий, каталог должен быть в `.gitignore`.
Нет сети — сообщи пользователю: схемы можно скопировать вручную из каталогов
`schemas/designer/<версия>/` репозитория https://github.com/yellow-hammer/namespace-forest.