cc-1c-skills/.github/skills/meta-decompile/SKILL.md

name, description, argument-hint, disable-model-invocation, allowed-tools

name	description	argument-hint	disable-model-invocation	allowed-tools
meta-decompile	Декомпиляция объекта метаданных 1С в JSON-заготовку формата meta-compile. Используй когда нужно получить черновик DSL-описания нового объекта по образцу другого. Не сохраняет UUID/модули/формы.	<ObjectPath> [-OutputPath <out.json>]	true	Bash Read Write Glob

/meta-decompile — DSL-заготовка из XML объекта метаданных

Читает XML объекта метаданных (Catalogs/Имя.xml и т.п.) и эмитит компактный JSON в формате /meta-compile. Назначение — взять существующий объект образцом и собрать по нему НОВЫЙ: декомпилировать → поправить → скомпилировать под другим именем.

⚠️ Главное: это НЕ обратимая выгрузка

Компиляция черновика создаёт новый объект с новой идентичностью, а не копию исходного. В JSON не попадают: UUID (идентичность самого объекта и всех дочерних), тела модулей, формы, макеты, права. Захватываются только структура и свойства.

Отсюда правило: никогда не компилируй черновик поверх объекта-источника и не выдавай его за «реимпорт» — у пересобранного объекта другие UUID, поэтому все ссылки на исходный объект (из кода, других объектов, состава подсистем, предопределённых данных) сломаются, а код модулей и формы пропадут.

Когда использовать

Собрать новый объект по образцу существующего — получить DSL-заготовку рабочего объекта, переименовать и адаптировать состав, скомпилировать в новый. Быстрее, чем писать DSL с нуля для богатого объекта.

Когда не использовать

• Точечная правка существующего объекта (добавить реквизит, ТЧ, свойство) → /meta-edit. Цикл decompile→compile тут вреден: даёт объект с новой идентичностью и теряет модули/формы.
• Сохранить / восстановить / перенести тот же объект (бэкап, миграция между конфигурациями с сохранением ссылок) → штатная выгрузка 1С (/db-dump-xml ↔ /db-load-xml, CF), а не decompile.
• Просто понять структуру объекта (реквизиты, ТЧ, типы) без пересборки → /meta-info (дешевле, не плодит файл).

Параметры

Параметр	Описание
ObjectPath	Путь к XML объекта (Catalogs/Имя.xml), обязательный
OutputPath	Путь к выходному JSON. Если не задан — JSON в stdout

powershell.exe -NoProfile -File ".github/skills/meta-decompile/scripts/meta-decompile.ps1" -ObjectPath "<Объект.xml>" -OutputPath "<out.json>"

Неподдерживаемый тип объекта или не-MetaDataObject root → ненулевой код выхода и сообщение в stderr.

Workflow (сборка нового объекта по образцу)

1. /meta-decompile <Образец.xml> -OutputPath draft.json — получить заготовку.
2. В draft.json сменить name на имя нового объекта и адаптировать состав (реквизиты/ТЧ/свойства). Ссылки на другие объекты (владельцы, ввод на основании, типы) — по имени, сохраняются как есть.
3. /meta-compile -JsonPath draft.json -OutputDir <ConfigDir> — собрать (объект получит свежие UUID).
4. /meta-validate + /meta-info — проверить.
5. Модули, формы, макеты, права — добавить отдельно (в черновик они не попадают).