xdto-edit — скилл для Claude Code: редактор пакетов XDTO 1С
Скилл xdto-edit для Claude Code точечно меняет типы и свойства в пакетах XDTO 1С. Включается при правке схемы без её полного переписывания.
MIT 36 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает xdto-edit
Вместо того чтобы читать и переписывать весь XML пакета, скилл меняет один элемент — тип, свойство, enum или namespace. Для больших пакетов вроде EnterpriseData (около мегабайта) это единственный практичный способ.
Операции: add-property, replace-property, remove-property, add-type, remove-type, add-enum, add-import, rename, set-namespace. Содержимое описывается фрагментом XSD — тем же языком, что в /xdto-compile. Многострочные фрагменты можно передать файлом через -Value "@frag.xsd". После правки автоматически запускается /xdto-validate.
Требуется PowerShell. Адресация через точку: Тип.Свойство, путь продолжается внутрь встроенных типов (ПлатежныйДокумент.ДатаСписано.ИдПлатежа). Переименование пакета через rename правит имя в объекте метаданных, файл <Имя>.xml, каталог и регистрацию в Configuration.xml. Смена namespace через set-namespace меняет targetNamespace и внутренние ссылки, но не трогает импортирующие пакеты — их надо править вручную.
Какие задачи решает
- добавить свойство в тип XDTO без чтения всего пакета
- переименовать пакет XDTO 1С и обновить регистрацию
- сменить namespace пакета XDTO
- удалить enum-значение или тип из схемы
- изменить ограничение длины строки в свойстве XDTO
Примеры запросов агенту
- Добавь свойство
Комментарийтипаxs:stringв типПлатёжпакетаDataExchange/Package.bin - Удали свойства
Платёж.ЧерновикиПлатёж.ВерсияФорматаиз пакетаExt/EnterpriseData.xml - Переименуй пакет XDTO
ОбменКлиентвОбменСБанком
Как установить xdto-edit
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-edit -a claude-code3Вручную: положить файлы
~/.claude/skills/xdto-edit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/xdto-edit/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-edit -a codex2Вручную: положить файлы
.agents/skills/xdto-edit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-edit -a cursor2Вручную: положить файлы
.cursor/skills/xdto-edit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/xdto-edit2Вручную: положить файлы
.github/skills/xdto-edit/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill xdto-edit -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/xdto-editВручную: положить файлы
.devin/skills/xdto-edit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о xdto-edit
Как установить xdto-edit в Claude Code?
Выполни /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills. Скилл активируется автоматически.
Что делает xdto-edit?
Точечно редактирует пакеты XDTO 1С: добавляет, удаляет или меняет типы, свойства, enum-значения и пространства имён без переписывания всей схемы. Для больших пакетов это быстрее и безопаснее, чем полная декомпиляция.
Как изменить ограничение длины строки в XDTO-свойстве?
Используй операцию replace-property с новым объявлением, в котором вложенный <xs:simpleType> содержит <xs:restriction> и <xs:maxLength>. Фасеты задаются только через вложенные типы, отдельных параметров нет.
Исходный текст
SKILL.md · MIT
---
name: xdto-edit
description: Точечное редактирование пакета XDTO 1С. Используй когда нужно добавить, изменить или удалить тип или свойство в существующем пакете, переименовать пакет, сменить пространство имён
argument-hint: <PackagePath> -Operation <операция> [-Target <путь>] [-Value <значение>] [-NoValidate]
allowed-tools:
- Bash
- Read
- Glob
---
# /xdto-edit — Точечное редактирование пакета XDTO
Меняет один элемент пакета, не требуя читать и переписывать всю схему — для больших
пакетов (`EnterpriseData` — около мегабайта) это единственный практичный путь.
Если нужно переработать схему целиком или сперва разобраться, как она устроена, —
`/xdto-decompile` → правка XSD → `/xdto-compile -Force`.
## Параметры
| Параметр | Обязательный | Описание |
|----------|--------------|----------|
| `PackagePath` | да | Каталог пакета, `Ext/Package.bin` или `<Имя>.xml`. Псевдоним — `-Path` |
| `Operation` | да | Операция из таблицы ниже |
| `Target` | зависит | Адрес: имя типа или путь `Тип.Свойство` |
| `Value` | зависит | Фрагмент XSD, литерал, URI или текст. `@путь` — взять содержимое из файла |
| `NoValidate` | нет | Не запускать `xdto-validate` после правки |
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-edit.ps1" -PackagePath "<путь>" -Operation <op> -Target "<адрес>" -Value "<значение>"
```
## Операции
| Операция | `-Target` | `-Value` |
|---|---|---|
| `add-property` | имя типа | `<xs:element>` или `<xs:attribute>` |
| `replace-property` | `Тип.Свойство` | новое объявление целиком |
| `remove-property` | `Тип.Свойство` | — |
| `add-type` | — | `<xs:complexType>` или `<xs:simpleType>` |
| `remove-type` | имя типа | — |
| `add-enum` | имя типа значения | литерал |
| `add-import` | — | URI пространства имён |
| `rename` | — | новое имя объекта метаданных |
| `set-synonym` | — | синоним |
| `set-comment` | — | комментарий |
| `set-namespace` | — | новый URI пространства имён |
Батч через `;;` там, где перечисление осмысленно: `remove-property`, `remove-type`,
`add-enum`, `add-import`.
```powershell
... -Operation add-property -Target "Платёж" -Value '<xs:element name="Комментарий" type="xs:string" minOccurs="0"/>'
... -Operation remove-property -Target "Платёж.Комментарий ;; Платёж.Черновик"
... -Operation add-enum -Target "ВидДокумента" -Value "Инкассо ;; Аккредитив"
... -Operation rename -Value ОбменСБанком
```
Содержимое всегда описывается фрагментом XML-схемы — тем же языком, что и в
`/xdto-compile`. Отдельных параметров вида `-MinOccurs` нет: чтобы поменять свойство,
дай его новое объявление целиком через `replace-property`.
Ограничение длины и прочие фасеты задаются вложенным типом:
```xml
<xs:element name="Комментарий" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:string"><xs:maxLength value="200"/></xs:restriction>
</xs:simpleType>
</xs:element>
```
Многострочный фрагмент передавай файлом: `-Value "@frag.xsd"`. Инлайн через оболочку
надёжен только для однострочных фрагментов без вложенных кавычек.
## Адресация
Путь `Тип.Свойство`. Точка безопасна: имена типов и свойств — идентификаторы 1С.
Путь продолжается внутрь встроенных типов: `ПлатежныйДокумент.ДатаСписано.ИдПлатежа`.
Посмотреть, что есть в пакете и как называется нужный тип, — `/xdto-info`.
Перед правкой типа полезно `/xdto-info -Mode used-by -Name <Тип>`: покажет,
кого затронет изменение.
## Что тянет за собой переименование и смена namespace
`rename` меняет имя в объекте метаданных, переименовывает файл `<Имя>.xml` и каталог
`<Имя>/`, правит регистрацию в `Configuration.xml`. Новое имя проверяется на
допустимость как идентификатор 1С и на занятость.
`set-namespace` меняет `targetNamespace`, все внутренние ссылки на собственные типы
и `<Namespace>` объекта метаданных. Пакеты, импортирующие старое пространство имён,
**не изменяются** — при версионировании они и должны продолжать смотреть на прежнее.
Навык их перечислит; если правка не версионная, поправь их импорты сам.
После правки автоматически запускается `/xdto-validate` — отключается через `-NoValidate`.
## Типичный workflow
1. `/xdto-info <пакет>` — найти нужный тип
2. `/xdto-info <пакет> -Mode used-by -Name <Тип>` — если меняешь существующее
3. `/xdto-edit <пакет> -Operation <op> …`
4. `/db-load-xml` + `/db-update`
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills