mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-06-10 16:14:54 +03:00

Files

T

Nick Shirokov 7a7d03dcff docs(skd-decompile): причёсываем SKILL.md перед merge

- description короче и с явным «не для точечных правок»
- унифицируем терминологию (sentinel-узлы)
- расширяем «Когда не использовать» — почему /skd-edit лучше для адресных правок
- в критичные конструкции добавляем вложенные схемы

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-25 13:07:53 +03:00

4.6 KiB

Raw Blame History

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

name

description

argument-hint

disable-model-invocation

allowed-tools

skd-decompile

Декомпиляция схемы компоновки данных 1С (СКД) в JSON-черновик в формате skd-compile. Используй для scaffold нового отчёта по образцу или структурного рефакторинга. Не для точечных правок

<TemplatePath> [-OutputPath <out.json>]

true

Bash

Read

Write

Glob

/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 — проверить.

4.6 KiB Raw Blame History Unescape Escape