About form-decompile
form-decompile converts a managed-form Form.xml into a compact JSON draft for form-compile. It is intended for scaffolding or structural refactoring, not precise edits to finished forms.
Key features
- 01Convert Form.xml to a JSON draft
- 02Represent form elements, attributes, and commands
- 03Write output to a file or stdout
- 04Report unsupported critical structures
Use cases
- 01Create a new form based on an existing one
- 02Refactor a form's structure through JSON
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ nikolay-shirokov/ cc-1c-skills --skill form-decompileAfter installing, type/form-decompilein Claude Code to confirm it loaded.
Bundled filesscripts/form-decompile.ps1scripts/form-decompile.py
Details
From the project README/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 "${CLAUDE_SKILL_DIR}/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
/form-decompile <Form.xml> -OutputPath draft.json— получить черновик.- Поправить JSON под задачу.
/form-compile -JsonPath draft.json -OutputPath new/Form.xml— собрать обратно./form-validate+/form-info— проверить результат.