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

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

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

/form-decompile — JSON-черновик из Form.xml управляемой формы

Читает Form.xml и эмитит компактный JSON в формате form-compile. Результат — черновик, а не обратимое представление: см. раздел «Что получаешь».

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

• Scaffold новой формы по образцу — взять существующую форму, получить JSON, поправить и скомпилировать в новую.
• Структурный рефакторинг — перебрать дерево элементов, реквизиты, команды.

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

• Точечные правки готовой формы (добавить элемент, реквизит, команду) → /form-edit. Цикл «декомпиляция → правка JSON → компиляция» переписывает форму целиком, может терять непокрытые конструкции и даёт большой diff. /form-edit правит адресно.

Параметры

Параметр	Описание
FormPath	Путь к Form.xml (обязательный)
OutputPath	Путь к выходному JSON. Если не задан — JSON в stdout

powershell.exe -NoProfile -File ".github/skills/form-decompile/scripts/form-decompile.ps1" -FormPath "<Form.xml>" -OutputPath "<out.json>"

Что получаешь

JSON-черновик в формате /form-compile — не полное обратимое представление: раундтрип xml → json → xml не гарантируется, часть конструкций DSL не покрывает и теряет молча.

Критичные конструкции (ConditionalAppearance со scope, design-time диаграммы/планировщики на реквизите, неизвестный тип элемента, не-Form root) → скрипт падает с ненулевым кодом и сообщением в stderr; для правок такой формы — /form-edit.

Workflow

1. /form-decompile <Form.xml> -OutputPath draft.json — получить черновик.
2. Поправить JSON под задачу.
3. /form-compile -JsonPath draft.json -OutputPath new/Form.xml — собрать обратно.
4. /form-validate + /form-info — проверить результат.