/skd-decompile — JSON-черновик из Template.xml СКД
Читает Template.xml и эмитит JSON в формате skd-compile. Результат — черновик, а не обратимое представление: см. раздел «Что получаешь».
Когда использовать
- Scaffold нового отчёта по образцу — взять существующий СКД, получить JSON, поправить и скомпилировать в новый.
- Структурный рефакторинг — переписать вариант, перерисовать шаблон, перебрать набор полей.
Когда не использовать
- Точечные правки готового отчёта (добавить поле, фильтр, итог, переименовать) →
/skd-edit. Цикл «декомпиляция → правка JSON → компиляция» переписывает шаблон целиком, может терять непокрытые конструкции и даёт большой diff в исходниках. /skd-edit правит адресно, без полной реконструкции.
Параметры
| Параметр |
Описание |
TemplatePath |
Путь к Template.xml (обязательный) |
OutputPath |
Путь к выходному JSON. Если не задан — JSON в stdout |
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-decompile.ps1" -TemplatePath "<Template.xml>" -OutputPath "<out.json>"
Что получаешь
JSON-черновик в формате /skd-compile — не полное обратимое представление СКД. На вход компилятору такой JSON напрямую может не пойти: в нём встречаются sentinel-узлы (маркер __unsupported__).
- Готовые узлы — большая часть СКД (поля, параметры, шаблоны, варианты со structure/filter/order/conditionalAppearance и т.п.) ложится в JSON как обычные узлы DSL.
- Sentinel-узлы — места, где встретилась конструкция, которую декомпилятор не умеет выразить в DSL. JSON остаётся валидным, но компилятор откажется его собирать, пока sentinel не заменён ручной реализацией (явный raw
template, прописанный appearance и т.п.) или не удалён, если в новом отчёте конструкция не нужна. Это намеренный барьер — чтобы непокрытое не уехало в финальный отчёт незамеченным.
<basename>.warnings.md рядом с OutputPath — список всех sentinel-узлов с координатами в исходнике, по нему удобно обходить места под ручную доработку.- Критичные конструкции (Picture cells, ХранилищеЗначения, вложенные схемы, не-СКД root) — скрипт падает с ненулевым кодом и сообщением в stderr; такой Template как образец не годится.
Workflow
/skd-decompile <Template.xml> -OutputPath draft.json — получить черновик.- Открыть
draft.warnings.md, посмотреть, что не покрылось.
- Поправить JSON под задачу. Sentinel-узлы — заменить на ручную реализацию (через явный raw
template, через ручное описание appearance и т.п.) либо удалить, если конструкция в новом отчёте не нужна.
/skd-compile -DefinitionFile draft.json -OutputPath new-Template.xml — собрать обратно./skd-validate + /skd-info — проверить.
1---2name: skd-decompile3description: Декомпиляция схемы компоновки данных 1С (СКД) в JSON-черновик в формате skd-compile. Используй для scaffold нового отчёта по образцу или структурного рефакторинга. Не для точечных правок4---56# /skd-decompile — JSON-черновик из Template.xml СКД78Читает Template.xml и эмитит JSON в формате `skd-compile`. **Результат — черновик**, а не обратимое представление: см. раздел «Что получаешь».910## Когда использовать1112- **Scaffold нового отчёта по образцу** — взять существующий СКД, получить JSON, поправить и скомпилировать в новый.13- **Структурный рефакторинг** — переписать вариант, перерисовать шаблон, перебрать набор полей.1415## Когда **не** использовать1617- **Точечные правки готового отчёта** (добавить поле, фильтр, итог, переименовать) → `/skd-edit`. Цикл «декомпиляция → правка JSON → компиляция» переписывает шаблон целиком, может терять непокрытые конструкции и даёт большой diff в исходниках. `/skd-edit` правит адресно, без полной реконструкции.1819## Параметры2021| Параметр | Описание |22|----------|----------|23| `TemplatePath` | Путь к Template.xml (обязательный) |24| `OutputPath` | Путь к выходному JSON. Если не задан — JSON в stdout |2526```powershell27powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-decompile.ps1" -TemplatePath "<Template.xml>" -OutputPath "<out.json>"28```2930## Что получаешь3132JSON-черновик в формате `/skd-compile` — **не полное обратимое представление СКД**. На вход компилятору такой JSON напрямую может не пойти: в нём встречаются sentinel-узлы (маркер `__unsupported__`).3334- **Готовые узлы** — большая часть СКД (поля, параметры, шаблоны, варианты со structure/filter/order/conditionalAppearance и т.п.) ложится в JSON как обычные узлы DSL.35- **Sentinel-узлы** — места, где встретилась конструкция, которую декомпилятор не умеет выразить в DSL. JSON остаётся валидным, но компилятор откажется его собирать, пока sentinel не **заменён ручной реализацией** (явный raw `template`, прописанный appearance и т.п.) **или не удалён**, если в новом отчёте конструкция не нужна. Это намеренный барьер — чтобы непокрытое не уехало в финальный отчёт незамеченным.36- **`<basename>.warnings.md`** рядом с `OutputPath` — список всех sentinel-узлов с координатами в исходнике, по нему удобно обходить места под ручную доработку.37- **Критичные конструкции** (Picture cells, ХранилищеЗначения, вложенные схемы, не-СКД root) — скрипт падает с ненулевым кодом и сообщением в stderr; такой Template как образец не годится.3839## Workflow40411. `/skd-decompile <Template.xml> -OutputPath draft.json` — получить черновик.422. Открыть `draft.warnings.md`, посмотреть, что не покрылось.433. Поправить JSON под задачу. Sentinel-узлы — заменить на ручную реализацию (через явный raw `template`, через ручное описание appearance и т.п.) либо удалить, если конструкция в новом отчёте не нужна.444. `/skd-compile -DefinitionFile draft.json -OutputPath new-Template.xml` — собрать обратно.455. `/skd-validate` + `/skd-info` — проверить.
Nikolay-Shirokov