skd-decompile — скилл для Claude Code: что делает и как установить
Скилл skd-decompile разбирает схему компоновки данных 1С из Template.xml в JSON-черновик для генератора skd-compile. Помогает собрать новый отчёт по готовому образцу.
MIT 40 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает skd-decompile
Скилл запускает скрипт skd-decompile.ps1 через PowerShell. Скрипт считывает схему СКД из исходного файла Template.xml и переводит поля, параметры, шаблоны и варианты структуры в JSON-черновик формата skd-compile. Если не указать ключ -OutputPath, результат выводится прямо в stdout.
Декомпиляция не гарантирует полную обратимость схемы. Все неподдерживаемые конструкции разметчик помечает маркером __unsupported__ и сохраняет их список с координатами в файл warnings с расширением .warnings.md. Без удаления таких узлов или их ручной замены сборщик skd-compile откажется компилировать схему. При обнаружении вложенных схем или ячеек Picture cells скрипт завершает работу с ошибкой.
Для точечных правок готового отчёта инструмент не подходит: цикл полной пересборки переписывает XML и раздувает diff в Git. Для добавления отдельных итогов или полей используйте команду /skd-edit.
Какие задачи решает
- декомпилировать Template.xml схемы компоновки 1С в JSON
- создать шаблон нового отчёта на базе существующей СКД
- подготовить черновик схемы для компилятора skd-compile
- найти неподдерживаемые конструкции СКД перед структурным рефакторингом
Примеры запросов агенту
- Декомпилируй схему отчёта:
/skd-decompile src/Reports/Sales/Template.xml -OutputPath draft.json - Разбери
Template.xmlв JSON-черновик с выводом в консоль:/skd-decompile Ext/Template.xml - Преобразуй СКД в черновик:
/skd-decompile ./Template.xml -OutputPath report.json
Как установить skd-decompile
1Через маркетплейс плагинов
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills/plugin install 1c-skills@cc-1c-skillsКоманда ставит плагин 1c-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill skd-decompile -a claude-code3Вручную: положить файлы
~/.claude/skills/skd-decompile/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skd-decompile/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill skd-decompile -a codex2Вручную: положить файлы
.agents/skills/skd-decompile/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill skd-decompile -a cursor2Вручную: положить файлы
.cursor/skills/skd-decompile/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/skd-decompile2Вручную: положить файлы
.github/skills/skd-decompile/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill skd-decompile -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/skd-decompileВручную: положить файлы
.devin/skills/skd-decompile/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о skd-decompile
Как установить skd-decompile в Claude Code?
Выполните в Claude Code две команды по порядку: сначала подключите маркетплейс через /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем запустите установку с помощью /plugin install 1c-skills@cc-1c-skills.
Для чего используется скилл skd-decompile?
Скилл преобразует файл Template.xml схемы СКД 1С в черновой JSON для компилятора skd-compile. Это позволяет быстро подготовить каркас нового отчёта по готовому образцу или провести масштабную переработку полей и вариантов.
Почему skd-decompile не подходит для точечных правок отчёта?
Декомпиляция переписывает структуру целиком, создаёт огромный diff в системе контроля версий и может потерять неподдерживаемые узлы. Для добавления полей, фильтров или итогов в готовый отчёт предназначен скилл /skd-edit.
Исходный текст
SKILL.md · MIT
---
name: skd-decompile
description: Декомпиляция схемы компоновки данных 1С (СКД) в JSON-черновик в формате skd-compile. Используй для scaffold нового отчёта по образцу или структурного рефакторинга. Не для точечных правок
argument-hint: <TemplatePath> [-OutputPath <out.json>]
disable-model-invocation: true
allowed-tools:
- 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
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
1. `/skd-decompile <Template.xml> -OutputPath draft.json` — получить черновик.
2. Открыть `draft.warnings.md`, посмотреть, что не покрылось.
3. Поправить JSON под задачу. Sentinel-узлы — заменить на ручную реализацию (через явный raw `template`, через ручное описание appearance и т.п.) либо удалить, если конструкция в новом отчёте не нужна.
4. `/skd-compile -DefinitionFile draft.json -OutputPath new-Template.xml` — собрать обратно.
5. `/skd-validate` + `/skd-info` — проверить.
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills